headscale
headscale
OfficialDocker app from gxs' Repository
Overview
Headscale aims to implement a self-hosted, open source alternative to the Tailscale control server.
Headscale's goal is to provide self-hosters and hobbyists with an open-source server they can use for their projects and labs. It implements a narrow scope, a single Tailnet, suitable for a personal use, or a small open-source organisation.
Installation:
Download config-0.xx.x.yaml and rename it to config.yaml (check for the latest version)
Download it from: https://github.com/bpivk/headscale and copy the file to /mnt/user/appdata/headscale/config
Edit:
server_url = Your vpn address
listen_addr (if changed from default)
base_domain = Your dns address
Use console to create users: headscale users create
Navigate to server_url/windows (for more OS versions read the link at the bottom)
Enter the url into a cmd/shell of the system that will use tailscale (tailscale needs to be installed)
Copy: headscale nodes register --user --key mkey: (replace )
If you're using the headscale plugin then install tailscale client and issue the following command: tailscale up --login-server YOUR_HEADSCALE_URL
For more information check here: https://headscale.net/setup/install/container/#register-a-machine-normal-login
Note:
-debug version is used because it includes a shell
Runtime arguments
- Web UI
http://[IP]:[PORT:8085]/windows- Network
bridge- Shell
sh- Privileged
- false
- Extra Params
--restart unless-stopped
Template configuration
DataPathrw
- Target
- /var/lib/headscale
- Default
- /mnt/user/appdata/headscale/data
- Value
- /mnt/user/appdata/headscale/data
ConfigPathrw
- Target
- /etc/headscale
- Value
- /mnt/user/appdata/headscale/config
Connecting PortPorttcp
- Target
- 8085
- Default
- 8085
- Value
- 8085
MetricsPorttcp
DON'T OPEN IN FIREWALL
- Target
- 9090
- Default
- 9090
- Value
- 9090
Categories
Download Statistics
2,637,009
Total Downloads
305,665
This Month
208,651
Avg / Month
Total Downloads Over Time
Loading chart...
Details
Repository
headscale/headscale:v0.26.1-debugLast Updated2026-04-18
First Seen2025-06-27
Run Headscale on Unraid.
Headscale is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.