selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

headscale logo

Self-host headscale

v0.29.7

Open-source Tailscale control server

ReleaseOpen SourceBSD-3-Clause
Updated2 weeks ago
LanguageGo
Setup difficultyModerate
Stars
45 713
Docker
docker.io/headscale/headscale

What is headscale?

Headscale lets you run your own Tailscale-compatible VPN control plane — a self-hosted, open-source server that manages WireGuard key exchange, IP allocation, and device connectivity for a personal or small-organization tailnet. It provides MagicDNS for hostname resolution, split DNS, subnet routers, exit nodes, ACL-based access control, and an embedded DERP relay for NAT traversal. Nodes can join via pre-shared keys, web login, or OpenID Connect (Authelia, Authentik, Keycloak, Google, Microsoft Entra ID). The server runs on Linux and BSD, installs via DEB packages, standalone binaries, Docker/Podman, or NixOS, and defaults to SQLite (PostgreSQL is supported but discouraged). Licensed under BSD-3-Clause, maintained by Kristoffer Dalby and Juan Font.

headscale alternatives

All self-hosted alternatives to Tailscale →

Should you self-host headscale?

headscale scores 82/100 on selfhost.directory (how scoring works) and ranks #1 of 31 in Networking. It has 45 713 GitHub stars, +1 173 in the last 30 days.

It shipped 8 stable releases in the past year. The latest, v0.29.7, came out on 30 October 2026. New versions land roughly every 2 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is BSD-3-Clause-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is Pangolin (78/100, 23 754 stars). headscale scores higher overall. See headscale vs Pangolin side by side.

headscale README

headscale logo

ci

headscale releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

More in Networking

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…