headscale

headscale

Official

Docker 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-debug
Last 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.