juanfont/headscale

Maintenance: ActiveBSD-3-ClauseGo

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

  1. It is a self-hosted alternative to the Tailscale control server.
  2. It handles WireGuard key exchange and assigns client IP addresses.
  3. 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

Latest release 30 Oct 2026

Checked 18 Nov 2026

Download page on GitHub

Found what you need? OpenPick is made by one person. Buy Andy a coffee.

Star growth

7 days: ▲ +256 stars30 days: not enough history

juanfont/headscalefatedier/frpshadowsocks/shadowsocks-windowsbannedbook/fanqiangLines show growth in percent since the first day.

Other options for the same problem

Head to head

Last activity 21 Nov 2026.

Cite as: headscale on OpenPick, https://openpick.ing/r/headscale, data as of 21 Nov 2026.

Report a mistake

Open on GitHub