juanfont

    juanfont/headscale

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

    45.3K stars
    2.6K forks
    45.3K GitHub watchers
    Updated Nov 3, 2026
    View on GitHub

    Build with Backblaze B2

    SDKs, agent skills, IDE extensions, and reference pipelines from Backblaze Labs. All open source.

    Explore Backblaze Labs

    Loading star history...

    Where it stands

    Rank, growth pace and release cadence relative to everything GStars tracks.

    4 releases in the last 90 days, the latest 3 days ago, with 256 contributors on GitHub.

    Peaked at #5 in the weekly ranking the week of Jul 19, its best in the past year.

    Use Cases & Benefits

    • Implements a self-hosted, open source control server compatible with Tailscale's VPN network using Wireguard technology.
    • Enables users to run a private Tailscale network without relying on proprietary control servers, enhancing privacy and control.
    • Use for creating a personal or small organization VPN network that securely connects multiple devices with NAT traversal.
    • Use for hobbyists and developers wanting to experiment with or extend Tailscale-like networking in a fully open source environment.
    • Use for deploying a lightweight, self-managed VPN control server in labs or projects requiring isolated network management.

    Should you depend on it?

    License terms, project hygiene and risks, from GitHub metadata and GStars' snapshots.

    License

    BSD 3-Clause

    Permissive: commercial use, modification and redistribution are allowed with attribution.

    Community files

    • README: present
    • Contributing guide: present
    • Code of conduct: present

    Watch-outs

    No watch-outs from GStars' checks.

    General guidance from repository metadata, not legal advice. How we score

    From the README

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

    Join our Discord server for a chat.

    Tailscale is a modern VPN built on top of Wireguard. It works like an overlay network between the computers of your networks - using NAT traversal.

    Everything in Tailscale is Open Source, except the GUI clients for proprietary OS (Windows and macOS/iOS), and the control server.

    The control server works as an exchange point of Wireguard public keys for the nodes in the Tailscale network. It assigns the IP addresses of the clients, creates the boundaries between each user, enables sharing machines between users, and exposes the advertised routes of your nodes.

    A Tailscale network (tailnet) is private network which Tailscale assigns to a user in terms of private users or an organisation.

    Headscale aims to implement a self-hosted, open source alternative to the Tailscale control server. Headscale's goal is to provide self-hosters and hobbyists with an open-source server they can use for their projects and labs. It implements a narrow scope, a single Tailscale network (tailnet), suitable for a personal use, or a small open-source organisation.

    Excerpt from the juanfont/headscale README on GitHub (BSD-3-Clause license). © its authors.Read the full README on GitHub

    Daily snapshots

    Stars gained per day, and how forks and open issues moved, from GStars' daily snapshots

    Aug 31: +58Sep 1: +62Sep 2: +27Sep 5: +14

    +2,407 stars over 79 days across 11 snapshot days; best day +62 on Sep 1.

    Forks

    2.6K+121

    Open issues

    111-31

    Compared with peers in Self-Hosted

    Fastest-growing repositories GStars tracks in this cohort for the week of Nov 8, by 7-day star growth

    juanfont/headscale compared with Self-Hosted repositories by stars, 7-day star growth, health score and last release
    RepositoryStars+7dHealthLast release
    milind-soni/OpenMausBot20.6K+8.4K75today
    debpalash/VoiceStudio107.3K+7.2K75today
    jub0t/Concat16.5K+2.5K755 days ago
    DuarteSantos8/openGym20.8K+1.7K757 days ago
    superplanehq/superplane9.8K+1.0K7513 days ago
    juanfont/headscale45.3K—653 days ago
    Category median20.6K+2.5K75—

    Discover Repositories

    Search across tracked repositories by name or description