Tools/juanfont/headscale

Headscale

Self-hosted Tailscale control server

43.9k+53/wkgrowthGoBSD 3-Clause "New" or "Revised" Licensetrending

The Lens

By Erik Loyd, SaaS CEO and former COO/CFO of an AWS Premier Partner.

Updated Aug 2026

Headscale is the self-hosted replacement for Tailscale's coordination server. Your devices still run the official Tailscale clients and still build direct WireGuard tunnels to each other; the difference is that the server telling them who's who is yours. BSD-3 licensed, completely free, community-driven, no paid tier.

Running it is a single binary with SQLite, light enough for a Raspberry Pi, though it needs a publicly reachable endpoint. The 0.29 release closed a real chunk of the gap with Tailscale's SaaS: grants for application-level policy, SSH sessions that can require fresh OIDC approval, and policy tests that reject a bad ACL before it lands. One upgrade gotcha: wildcard ACLs no longer mean all IPs, and hostname collisions now renumber, which can change MagicDNS names.

Solo and homelab: free, and one of the most popular self-hosted networking tools going. Small teams: real savings vs Tailscale's $6/user/mo once you pass a handful of users. Large orgs: Tailscale's managed offering buys support and compliance you'd otherwise staff yourself.

The catch: you're the support team. No admin dashboard polish, no device posture checks, and DERP relays for hard NAT cases are extra setup or a dependency on Tailscale's public ones.

Free vs Self-Hosted vs Paid

fully free

Fully Free

Headscale is 100% free and open source under BSD-3-Clause. No paid tier, no managed offering.

Self-Hosted Setup

Single binary or Docker. SQLite database (default) or Postgres. Minimal resource requirements; runs on a Raspberry Pi. Needs a publicly accessible server for the coordination endpoint. Uses official Tailscale clients on endpoints. Configuration via YAML file.

What You Get for $0

  • WireGuard mesh networking with NAT traversal
  • ACLs, grants, and policy tests for access control
  • DNS and MagicDNS
  • OIDC authentication, including per-session SSH approval
  • Pre-auth keys for automated enrollment
  • Multiple users/namespaces
  • API for automation

The Math

Headscale: $0 + a $5/mo VPS for the control server. Tailscale free: 3 users, 100 devices. Tailscale Personal Pro: $6/user/mo. For a team of 20: Tailscale at $120/mo vs Headscale at $5/mo. The trade-off is ops time vs monthly cost.

Verdict

Free and fully functional. If you're comfortable self-hosting, the savings over Tailscale's paid plans are significant. Use Tailscale's free tier first to validate the workflow, then migrate to Headscale if cost or control matters.

Free. Saves $6/user/mo vs Tailscale paid plans. Trade-off is self-hosting ops vs managed convenience.

What to do by team size

Solo
free; great for homelab networking
Small team
free; saves real money vs Tailscale paid at 5+ users
Medium team
free; strong option if you have ops capacity
Large team
Tailscale Enterprise for compliance and support
Self-hosting ops:moderate
View pricing page →

Get tools like this every Wednesday

One featured tool, three on the radar. No fluff.

Similar Tools

Score
84/100 · A
Adoption27/30
Maintenance21/25
Community11/20
License15/15
Analysis10/10

A low score is not a verdict on quality. Young and niche tools start low by design. How we calculate scores

Trust Signals

High adoption: 37,485 starsActive community: 2,030 forksPermissive license (BSD-3-Clause)

About

Stars
43,900
Forks
2,570

Explore Further

More tools in the directory