About Headscale
Headscale is a self-hosted, open-source take on the Tailscale control server. Tailscale is a VPN built on WireGuard that works as an overlay network between your computers using NAT traversal, and the control server is the piece that exchanges WireGuard public keys, assigns IP addresses, separates users and shares routes. Headscale replaces that coordination role with software you run yourself. It is written in Go under the BSD-3-Clause license.
The project has a deliberately narrow scope. It implements a single Tailscale network, called a tailnet, which is suitable for personal use or a small open-source organization, and it aims to give self-hosters and hobbyists a server for their projects and labs. The README explains that Tailscale's own clients and control server are not all open source, which is the gap Headscale fills.
Documentation is published for both stable and development versions, and the maintainers advise using the same Git tag as the release you run so the example configuration matches. A Discord server offers community chat. Headscale suits homelab users and small teams who want private mesh networking without relying on a hosted coordination service.
Key features
- Self-hosted Tailscale control server
- Key exchange and IP address assignment for nodes
- Single tailnet for personal or small-team use
- User separation and machine sharing
- Advertised route support
- Documentation for stable and development versions
Good fit for
- →Private mesh VPN for a homelab
- →Self-hosted coordination for a small team
- →Avoiding a hosted control plane
- Built with
- Go
- Tags
- vpn
- wireguard
- tailscale
- self-hosted
- mesh-network
- golang
- networking
- homelab
Headscale: questions and answers
- What is Headscale used for?
- Headscale is a self-hosted, open-source replacement for the Tailscale control server, built for personal networks, labs and small organizations. It is a good fit for private mesh VPN for a homelab, self-hosted coordination for a small team and avoiding a hosted control plane.
- 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; there is no official hosted version.
- 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 wg-easy, OpenVPN and NetBird.
- Is Headscale actively maintained?
- Yes. The most recent commit to Headscale was on 2 October 2026, and the latest release is v0.29.4, published on 23 September 2026. The project has 44k stars on GitHub.
Open-source alternatives to Headscale
See all
wg-easy
Networking & VPN
The easiest way to run WireGuard VPN + Web-based Admin UI.
AGPL-3.0vs NordVPN★ 27k
OpenVPN
Networking & VPN
OpenVPN is an open source VPN daemon
OSSvs NordLayer★ 15k
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.1k
NetBird
Networking & VPN
Connect your devices, users, and agents into a secure WireGuard®-based overlay network wit
OSSvs Tailscale★ 30k
Netmaker
Networking & VPN
Securely connect your devices, clouds, and sites with Netmaker's Zero Trust platform.
OSSvs Tailscale★ 12k
Pangolin
Networking & VPN
Open-source SASE platform providing secure access and connectivity to apps, infrastructure
OSSvs Cloudflare Tunnel★ 23k
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