# 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 dashboard for managing network nodes, API keys, and server settings. It is open source and self-hosted, installable on TrueNAS, Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1034/headscale-admin

## Description

Headscale-Admin is a simple, modern web interface for Headscale, an open-source self-hosted implementation of the Tailscale control server, providing a dashboard for managing network nodes, API keys, and server settings. Currently in active development, it is considered beta and should not be treated as a final product.

## Platform availability

Available on 2 of 9 platforms: Unraid, TrueNAS.

## Health score

39/100 (Low), based on 3 of 4 factors.
- Maintained: 28 (last commit 451 days ago)
- Popular: 61 (1,116 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- TrueNAS: https://apps.truenas.com/catalog/headscale
- Docker Hub: https://hub.docker.com/r/goodieshq/headscale-admin
- Unraid: https://ca.unraid.net/apps/headscale-admin-10wjvxu13s3tkm?q=headscale-admin

## 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.

## Alternatives

- 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 (&quot;SoftEther&quot; means &quot;Software Ethernet&quot;) 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 a self-hosted secure remote access platform that combines WireGuard virtual private network (VPN), identity and access manageme…
- ngrok: ngrok creates secure tunnels from the internet to your local network, letting you expose local development servers, APIs, and applications…

---
Source: Our Local Host (https://ourlocalhost.com/app/1034/headscale-admin), the self-hosted and open-source app directory.
