Headscale
Headscale is a BSD-3-Clause, self-hosted implementation of the Tailscale control server, written in Go for homelabs and small organisations.
- GitHub stars
- 46k
- Last commit
- yesterday
- Latest release
- v0.29.7
- Licence
- BSD-3-Clause
- Self-hosted
- Yes
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























