Headscale

Open source

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 30 days
+1.1k(+2%)
Last commit
yesterday
Repository age
6 years
Version
v0.29.7
Licence
BSD-3-Clause
Self-hosted
Yes

About Headscale

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

Good fit for

  • Personal tailnet for home or lab machines
  • Small open-source organisation network
Built with
Go tools
Tags
vpn
wireguard
tailscale
self-hosted
go
networking
mesh

Headscale: questions and answers

What is Headscale used for?
Headscale is a BSD-3-Clause, self-hosted implementation of the Tailscale control server, written in Go for homelabs and small organisations. It is a good fit for personal tailnet for home or lab machines and small open-source organisation network.
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.
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 OpenVPN, wg-easy and ZeroTier.
Is Headscale actively maintained?
Yes. The most recent commit to Headscale was on 12 November 2026, and the latest release is v0.29.7, published on 30 October 2026. The project has 46k stars on GitHub, with 1.1k added in the last 30 days.

Open-source alternatives to Headscale

See all

SaaS alternatives to Headscale

See all