HackerReposA FIELD GUIDE TO OPEN SOURCE
ProSponsor the shelf♧ 0
← Back to top all-time
juanfont
headscale
Go2020–2026
juanfont / headscale

headscale

An open source, self-hosted implementation of the Tailscale control server

103Distinct people
124Mentions
0Explicit recommenders
45.7KGitHub stars
REPOSITORY AT A GLANCE

What to know before exploring

What it is

An open source, self-hosted implementation of the Tailscale control server

GitHub

Where it is used

  • Janus Chung’s K3s cluster — Janus Chung’s K3s cluster uses Headscale to run a coordination server that Tailscale clients connect to over HTTPS via Traefik. This powers his self-hosted network setup. Source
  • Frank, the Talos Cluster — Frank, the Talos Cluster runs Headscale and exposes its STUN service on UDP 3478 via hostPort, necessitating a Recreate deployment strategy on its single-node setup. Source

What people are saying

No recommendation phrase was found in the indexed comments.

No classified warning is attached to this page. Read the discussions before treating silence as approval.

Also in these discussions

Mentioned in the same Hacker News threads. That is not proof they are substitutes.

This week on Hacker News

Nov 9–Nov 16 UTC · Direct repository links and separately labeled related project stories. Indexed through 11/16/2026, 4:59:52 AM UTC.

No direct repository links were found in the indexed HN discussions over the past seven days. Older discussions are available below.

Mentions over time

HN mentions by year124 dated mentions

Observed mentions: 2020-07-05 03:46:30 UTC to 2026-08-13 13:56:14 UTC.

010203040502020-01-01 00:00:00 UTC to 2021-01-01 00:00:00 UTC (exclusive): 1 mentions; 0 submissions, 1 comments20202021-01-01 00:00:00 UTC to 2022-01-01 00:00:00 UTC (exclusive): 15 mentions; 4 submissions, 11 comments2022-01-01 00:00:00 UTC to 2023-01-01 00:00:00 UTC (exclusive): 45 mentions; 2 submissions, 43 comments2023-01-01 00:00:00 UTC to 2024-01-01 00:00:00 UTC (exclusive): 22 mentions; 2 submissions, 20 comments20232024-01-01 00:00:00 UTC to 2025-01-01 00:00:00 UTC (exclusive): 10 mentions; 1 submissions, 9 comments2025-01-01 00:00:00 UTC to 2026-01-01 00:00:00 UTC (exclusive): 20 mentions; 2 submissions, 18 comments2026-01-01 00:00:00 UTC to 2027-01-01 00:00:00 UTC (exclusive): 11 mentions; 1 submissions, 10 comments. Incomplete calendar period.2026*

* An incomplete calendar period is marked with an outlined bar. Its count is not directly comparable with a full period.

Counts come from the repository’s dated source evidence. Index cutoff: 2026-11-02 08:16:59 UTC.

View mention counts and date ranges
UTC ranges include their start and exclude their end. Select a period to filter the source evidence.
PeriodStart (UTC)End (exclusive, UTC)MentionsSubmissionsComments
20202020-01-01 00:00:00 UTC2021-01-01 00:00:00 UTC101
20212021-01-01 00:00:00 UTC2022-01-01 00:00:00 UTC15411
20222022-01-01 00:00:00 UTC2023-01-01 00:00:00 UTC45243
20232023-01-01 00:00:00 UTC2024-01-01 00:00:00 UTC22220
20242024-01-01 00:00:00 UTC2025-01-01 00:00:00 UTC1019
20252025-01-01 00:00:00 UTC2026-01-01 00:00:00 UTC20218
2026 (partial)2026-01-01 00:00:00 UTC2027-01-01 00:00:00 UTC11110

What Hacker News says

22 sources
Indeed, we use Headscale [1] to maintain a Wireguard mesh. Synology NAS devices can act as Wireguard endpoints, but we also pick SMB routers that can do the same. I'm partial to Glinet at the moment (GL.iNet GL-MT3000 (Beryl AX) [2]), but the recent HN thread on the UniFi Express [3] has me keeping an eye on it (no Wireguard support I believe). [1] https://github.com/juanfont/headscale [2] https://www.gl-inet.com/products/gl-mt3000/ [3] https://news.ycombinator.com/item?id=38504027
In A case for moving away from the cloud and embracing local storage solutions
I don't think the service is so much "tailscale for mullvad users" but the other way around, it's intended for existing tailscale users to get an "exit node" of sorts in their tailscale network without having to set it up themselves. Tailscale's business model has never been anonymity, last I used them they even required either a Google or O365 account to even use the service. You might want to look into Headscale[1] instead, it's a server-side implementation of Tailscale that you can self-host. It comes with its own drawbacks but from what I've seen it's worth it if you want more control over the network. [1]: https://github.com/juanfont/headscale
In Bug in macOS 14 Sonoma prevents our app from working
> Narrowlink and Tailscale are two open source solutions with different architectures that enable secure remote access and connectivity across networks. A nitpick, but ironically I think they're being generous to Tailscale there. Tailscale isn't really "open source" - or at least not without heavy qualification. I'm not an open source zealot by any means but that line just seems a little misleading. The clients are partially open source [0], but the server isn't at all. There is an open-source implementation of the Tailscale server called Headscale, but Headscale is not Tailscale. This distinction is important because a significant part of the value proposition of Tailscale compared to other overlay/mesh networks is their very well designed web UI which makes managing their Wireguard based networks very user friendly. Headscale has no UI
Read the rest
(edit: there are some third-party "unofficial" Headscale UIs [2]). In fact the Headscale repo still says explicitly "This project is not associated with Tailscale Inc." [1] even though I understand that it is (unofficially?) supported by Tailscale these days. [0] https://github.com/tailscale/tailscale [1] https://github.com/juanfont/headscale [2] https://github.com/juanfont/headscale/blob/main/docs/web-ui....
In Tailscale vs. Narrowlink
> https://github.com/juanfont/headscale The tailscale daemon/CLI/client code is already open source and works with the above as the control server. The tailscale team appear to be encouraging development of headscale too: "Our opinion is that Headscale provides a valuable complement to Tailscale: It helps personal users better understand both how Tailscale works and how to run a coordination server at home. As such, Tailscale works with Headscale maintainers when making changes to Tailscale clients that might affect how the Headscale coordination server works, to ensure ongoing compatibility." > https://tailscale.com/opensource/ Personally I find WireGuard and tailscale/headscale to be extremely complementary, and with these you don't cede any control vs running WireGuard on its own.
In Make your own VPN with Fly.io, tailscale and GitHub

Showing the 15 most recent of 22 sources. Enable JavaScript to search and browse every indexed mention.

MAKE YOURSELF AT HOME

A few shortcuts

/
Search the collection
?
Open this guide
Esc
Close dialogs and navigation

Your saved repositories and interests stay in this browser.