Skip to content
appsgit

Headscale

Headscale is an open-source, self-hosted app in the Proxy & VPN category, licensed BSD-3-Clause and written mainly in Go. It is a self-hosted alternative to Tailscale and ships a Docker image. It has 45,756 GitHub stars and its last commit was on Nov 16, 2026 (data as of Nov 16, 2026).

github.com/juanfont/headscale

GitHub stats

GitHub stars
45,756
Forks
2,645
Open issues
54
Commits, last 12 months
1,600
Last commit
Nov 16, 2026
Latest release
v0.29.7Oct 30, 2026
Created
Jun 21, 2020
License
BSD-3-ClauseOpen source

Data as of from the GitHub API. Report an error

Project health

ActiveActive: last commit Nov 16, 2026, 1,600 commits in 12 months.

Raw inputs behind the health label
Last commitNov 16, 2026
Commits, last 12 months1,600
Latest releasev0.29.7 (Oct 30, 2026)
Releases, last 12 months8
Releases, all time144
Open issues54
Open pull requests31
Good first issues3
Contributing guideYes
Security policyNo
CreatedJun 21, 2020

Health as of , from the GitHub API. A label describes activity, not quality or security. How we label project health · Report a data error

About Headscale

Open-source, self-hosted implementation of the Tailscale control server.

Description written by appsgit. Source code: github.com/juanfont/headscale.

Topics

  • tailscale
  • tailscale-control-server
  • wireguard
  • tailscale-server

Open-source alternative to

Headscale can replace these commercial products. Compare every option on each page.

Repository preview

Headscale repository previewjuanfont/headscaleOpen repository

FAQ

Headscale FAQ

Still curious? Email info@appsgit.com.

Is Headscale free and open source?

Yes. Headscale is open-source software released under the BSD-3-Clause license, so you can self-host it at no cost. You only pay for the server it runs on, and some projects also offer an optional paid cloud plan.

Can I run Headscale with Docker?

Yes. Headscale provides a Docker image, so you can run it on any Linux server with Docker and Docker Compose installed. The project README lists the image name and the environment variables to set.

What are the best alternatives to Headscale?

Popular self-hosted alternatives to Headscale include frp, NetBird and wg-easy. Headscale itself is a self-hosted alternative to Tailscale.

Is Headscale actively maintained?

The most recent commit to Headscale was on Nov 16, 2026 with 1,600 commits in the past twelve months. The latest release is v0.29.7, published Oct 30, 2026. It had 54 open issues on GitHub. appsgit's project-health label for it is "Active" as of Nov 16, 2026.