juanfont/headscale
headscale is an open source tool in VPN and proxy with 45,961 GitHub stars (+256 in the last 7 days), BSD-3-Clause license, actively maintained, as of 21 Nov 2026.
What is headscale?
Headscale is a self-hosted open source control server for Tailscale. It connects your devices with WireGuard keys and gives them IP addresses.
- Replaces
- Tailscale control server
- Good for
- Running your own control server for a personal Tailscale network
- Building a private overlay network for a home lab
Three takeaways
- It is a self-hosted alternative to the Tailscale control server.
- It handles WireGuard key exchange and assigns client IP addresses.
- It supports one Tailscale network (tailnet), for personal or small use.
What can you use headscale for?
- Running your own control server for a personal Tailscale network
- Building a private overlay network for a home lab
- Managing a small open-source organization's network
- Sharing machines between users in one tailnet
- Exposing routes advertised by your nodes
Who is headscale for?
- Self-hosters and hobbyists who want an open source control server
- Personal or small organization networks with a single tailnet
Who should skip headscale?
- Large multi-tenant or multi-tailnet deployments
- Users who want a managed service with no server to run
Quick answers
- Is headscale free to use at work?
- Yes. BSD-3-Clause: Free to use at work. Keep the copyright notice. Do not use the authors' names to promote your product. Not legal advice.
- Is headscale still maintained?
- Active. 827 commits in the last 90 days. Latest release 30 Oct 2026.
- Does headscale run on Windows, macOS or Linux?
- Its latest release lists these platforms: macOS, Linux. Checked 18 Nov 2026.
- How popular is headscale?
- 45,961 GitHub stars. +256 in the last 7 days. As of 21 Nov 2026.
- What does headscale replace?
- headscale can replace Tailscale control server.
- Stars
- 45,961
- Forks
- 2,658
- Watchers
- 213
- Stars, 24 hours
- +41
- Stars, 7 days
- +256
Numbers as of 21 Nov 2026, 20:30 UTC
Health
99 out of 100Active
- Issues
- 1,344 closed / 55 open
- Pull requests
- 1,504 merged / 34 open
- Commits, last 90 days
- 827
- Latest release
- 30 Oct 2026 (144 in all)
Checked 18 Nov 2026
Get it
- macOS
- Linux
Found what you need? OpenPick is made by one person. Buy Andy a coffee.
Star growth
7 days: ▲ +256 stars30 days: not enough history