About Headscale
Headscale is an open source, self-hosted implementation of the Tailscale control server. Tailscale is a VPN built on WireGuard that links machines into an overlay network using NAT traversal. The control server exchanges WireGuard public keys, assigns client IP addresses, sets boundaries between users, and exposes the routes your nodes advertise.
The design goal is a self-hosted alternative for self-hosters and hobbyists to use in projects and labs. The scope is deliberately narrow: a single Tailscale network (tailnet), suitable for personal use or a small open-source organisation. Features and client operating system support are documented on the project's documentation site.
It is not associated with Tailscale Inc, although one active maintainer works there. The README advises matching the GitHub tag to the release you run so example configuration fits, and it provides a NixOS module plus development builds as container images and binaries. It also says reverse proxies and containers are not supported or encouraged.
Key features
- Self-hosted Tailscale control server
- Exchanges WireGuard public keys between nodes
- Assigns client IP addresses and user boundaries
- Exposes advertised routes of nodes
- NixOS module available
- Development builds as images and binaries
Good fit for
- Personal tailnet for home or lab machines
- Small open-source organisation network
Headscale: questions and answers
- What is Headscale used for?
- Headscale is a BSD-3-Clause, self-hosted implementation of the Tailscale control server, written in Go for homelabs and small organisations. It is a good fit for personal tailnet for home or lab machines and small open-source organisation network.
- Is Headscale open source?
- Yes. Headscale is open source under the BSD-3-Clause licence. Its source code is on GitHub at juanfont/headscale and is written mainly in Go.
- Is Headscale free?
- Yes. Headscale is open source, so the software itself is free to use.
- Can I self-host Headscale?
- Yes. Headscale can be self-hosted on your own server or infrastructure.
- What is Headscale an alternative to?
- Headscale is an open-source alternative to Tailscale, NordVPN, NordLayer and ExpressVPN. Other open-source alternatives to Tailscale include OpenVPN, wg-easy and ZeroTier.
- Is Headscale actively maintained?
- Yes. The most recent commit to Headscale was on 12 November 2026, and the latest release is v0.29.7, published on 30 October 2026. The project has 46k stars on GitHub, with 1.1k added in the last 30 days.
Open-source alternatives to Headscale
See all
OpenVPN
Networking & VPN
OpenVPN is an open source VPN daemon
OSSvs NordLayer★ 15k
wg-easy
Networking & VPN
The easiest way to run WireGuard VPN + Web-based Admin UI.
AGPL-3.0vs NordVPN★ 27k
IPsec VPN Server
Networking & VPN
Docker image to run an IPsec VPN server, with IPsec/L2TP, Cisco IPsec and IKEv2. Auto-gene
OSSvs ExpressVPN★ 7.2k
ZeroTier
Networking & VPN
A Smart Ethernet Switch for Earth
OSSvs Tailscale★ 17k
Tailscale
Networking & VPN
The easiest, most secure way to use WireGuard and 2FA.
BSD-3-Clausevs Twingate★ 39k
NetBird
Networking & VPN
Connect your devices, users, and agents into a secure WireGuard®-based overlay network wit
OSSvs Tailscale★ 31k
SaaS alternatives to Headscale
See all
Tailscale
Networking & VPN
Mesh VPN and zero trust network that connects devices without manual configuration
SaaS
NordVPN
Networking & VPN
Consumer VPN service with threat protection, double VPN and meshnet
SaaS
NordLayer
Networking & VPN
Business VPN and network access security for remote and hybrid teams
SaaS
ExpressVPN
Networking & VPN
Consumer VPN service with apps for desktop, mobile, routers and browsers
SaaS
Surfshark
Networking & VPN
Consumer VPN with unlimited device connections plus antivirus and data alert add-ons
SaaS
CyberGhost
Networking & VPN
Consumer VPN service with streaming-optimized servers and a no-logs policy
SaaS
Hotspot Shield
Proton VPN
Private Internet Access
Mullvad VPN
IPVanish
TunnelBear
Windscribe
VyprVPN
hide.me
PureVPN
Cloudflare Tunnel