# juanfont/headscale

Canonical: https://openpick.ing/r/headscale
As of: 2026-11-21 20:30 UTC


headscale is an open source tool in VPN and proxy with 45,961 GitHub stars (+256 in the last 7 days), BSD-3-Clause license, actively maintained, as of 21 Nov 2026.

## Answer
Headscale is a self-hosted open source control server for Tailscale. It connects your devices with WireGuard keys and gives them IP addresses.

### Replaces
- Tailscale control server (confidence 95%)

## Takeaways
- It is a self-hosted alternative to the Tailscale control server.
- It handles WireGuard key exchange and assigns client IP addresses.
- It supports one Tailscale network \(tailnet\), for personal or small use.

## Use cases
- Running your own control server for a personal Tailscale network
- Building a private overlay network for a home lab
- Managing a small open-source organization's network
- Sharing machines between users in one tailnet
- Exposing routes advertised by your nodes

## Fit for
- Self-hosters and hobbyists who want an open source control server
- Personal or small organization networks with a single tailnet

## Not for
- Large multi-tenant or multi-tailnet deployments
- Users who want a managed service with no server to run

## Setup difficulty
medium

## Quick answers
### Is headscale free to use at work?
Yes. BSD-3-Clause: Free to use at work. Keep the copyright notice. Do not use the authors' names to promote your product. Not legal advice.

### Is headscale still maintained?
Active. 827 commits in the last 90 days. Latest release 30 Oct 2026.

### Does headscale run on Windows, macOS or Linux?
Its latest release lists these platforms: macOS, Linux. Checked 18 Nov 2026.

### How popular is headscale?
45,961 GitHub stars. +256 in the last 7 days. As of 21 Nov 2026.

### What does headscale replace?
headscale can replace Tailscale control server.

## Stats
- Category: VPN and proxy
- 45,961 stars, as of 2026-11-21 20:30 UTC
- +256 stars in 7 days
- License: BSD-3-Clause (Yes: Free to use at work. Keep the copyright notice. Do not use the authors' names to promote your product.). Not legal advice. License: https://github.com/juanfont/headscale
- GitHub: https://github.com/juanfont/headscale

## Get it
Platforms: macOS, Linux
Latest release: 2026-10-30
Release page: https://github.com/juanfont/headscale/releases/tag/v0.29.7
Checked: 2026-11-18

## Health
Maintenance: Active
Health: 99/100 (as of 2026-11-18)
- Issues: 55 open / 1,344 closed
- Pull requests: 34 open / 1,504 merged
- Commits in the last 90 days: 827
- Latest release: 2026-10-30 (144 releases)

## Head to head
- [fatedier/frp vs juanfont/headscale](https://openpick.ing/compare/frp-vs-headscale)

Cite as: headscale on OpenPick, https://openpick.ing/r/headscale, data as of 21 Nov 2026.

AI-generated content. Content updated 2026-11-17 11:35 UTC.

See Methodology: https://openpick.ing/methodology · Disclaimer: https://openpick.ing/disclaimer