Headscale-admin
Headscale-Admin is a simple, modern web interface for Headscale, an open-source self-hosted implementation of the Tailscale control server, providing a…
Platform availability
Available on 2 of 10 platforms
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
44/100 Fair
- Maintained
- 25last commit 479 days ago
- Popular
- 611,127 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
- Security check
- 70no serious findings, 13 minor, CI, tests
Based on 4 of 5 factors.
Availability: platform listings confirmed today, links checked 48 days ago
- GitHub stars
- 1,127
- Open issues
- 21
- Last commit
- 2025-07-30
- Latest release
- v0.28.0
- License
- GPL-3.0
- Activity
- stale
Checked 20 days ago - source: GitHub (GoodiesHQ/headscale-admin)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Make config and data folders first Before running the container, create the config and lib folders and put your edited config.yaml in the config folder. These folders hold your settings and device/user data, so the container needs them or it may fail or have nowhere to save your network. source
- Ports 8080/9090 may be local-only The example command publishes ports 8080 and 9090 to 127.0.0.1 only, which means only the machine running Headscale can reach them. Port 8080 is the main API/admin entry point and 9090 is for health/metrics, so if headscale-admin is on another device you’ll need a way to forward those ports to your network. source
- Keep a backup of config and data Before changing anything, make a backup copy of your config folder and data folder, because they store your Headscale settings, users, and devices. If they are lost or corrupted, you may lose your network and have to set it up again. source
- Same DNS record Host both headscale and Headscale-Admin on the same DNS record. source
- NPM reverse proxy For NPM, use Custom locations with /admin/ as the location and forward the IP and port from this container. source
- API key setup Run 'headscale apikeys create' in the headscale console to generate the API key required by Headscale-Admin. source
Fetched 45 days ago - each note links to its source
Variants
Alternatives (9)
- Headscale - Headscale is an open-source, self-hosted implementation of the Tailscale control server.
- LogMeIn Hamachi - Seamlessly connects devices and networks, extending LAN-like connectivity to mobile users and teams with a secure, hosted VPN service.
- NetBird - NetBird is an open-source Zero Trust networking platform that makes it easy for engineers to create fast, secure, and private networks with…
- SoftEther VPN - SoftEther VPN ("SoftEther" means "Software Ethernet") is one of the world's most powerful and easy-to-use multi-protoco…
- Tailscale - Private networks made easy.
- ZeroTier - ZeroTier is an open-source, cross-platform virtual LAN/VPN service that connects your devices and servers into one private network, so you…
- defguard - defguard is an SSO & VPN Server based on OpenID and WireGuard VPN with unique secure & private architecture for building secure and…
- ngrok - ngrok creates secure tunnels from the internet to your local network, letting you expose local development servers, APIs, and applications…
- nostr vpn - Nostr VPN turns your Umbrel into a private mesh VPN node for your own devices and trusted groups.
Checked 40 days ago - source: AlternativeTo
Common questions
Does headscale-admin need password protection or SSO to secure it?
No, password protection or SSO is not required. The UI is stateless and keeps the API key only in your browser, so securing the API key and using TLS is what matters.
Can headscale-admin be hosted on a subdomain different from headscale?
Yes, but you must allow the headscale-admin domain in headscale's CORS headers so browser requests succeed.
What ports are used in an Unraid reverse-proxy setup for Headscale and Headscale-Admin?
A shared configuration runs Headscale on port 1111 and Headscale-Admin on port 1112, then reverse-proxies them through NGINX Proxy Manager.
What headscale data should I back up before changing it?
Back up the headscale config and data folders before making changes, because they store the settings, users, and devices.
Answers sourced from forums.unraid.net, github.com, headscale.net
Community
- Headscale-Admin (new web UI) : r/headscale - Reddit (reddit)
- Has anyone used Headscale? : r/selfhosted - Reddit (reddit)
- headscale - Reddit (reddit)
- [Support] Headscale-admin - A UI for headscale - Unraid (forum)
Collected 48 days ago - public community threads