7,380 open-source and SaaS tools, with GitHub stats refreshed every day.

Headscale

Open source

A self-hosted, open-source replacement for the Tailscale control server, built for personal networks, labs and small organizations.

GitHub stars
44k
Last commit
today
Repository age
6 years
Version
v0.29.4
Licence
BSD-3-Clause
Self-hosted
Yes

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

SaaS alternatives to Headscale

See all