headscale

headscale

Canonical Publisher Verified account Verified account

Install latest/stable of headscale

Ubuntu 16.04 or later?

Make sure snap support is enabled in your Desktop store.


Install using the command line

sudo snap install headscale

Don't have snapd? Get set up for snaps.

Channel Version Published

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

See https://headscale.net/ for upstream documentation.

Getting started

Install the snap:

sudo snap install headscale

The snap provides a headscale service (headscale serve) with an initial example configuration, started automatically on install. It also provides the headscale command to interact with the service. You will need to configure the service by editing the configuration file at /var/snap/headscale/common/config.yaml. See https://github.com/canonical/headscale-snap/blob/main/docs/config-reference.md for more information on configuration.

Security

See https://github.com/canonical/headscale-snap/blob/main/docs/security-reference.md for security and hardening documentation.

This snap is maintained by Canonical, and is not necessarily endorsed or officially maintained by the upstream developers.

Details for headscale

License
  • BSD-3-Clause

Last updated
  • 23 July 2025 - latest/stable
  • 23 July 2025 - latest/candidate

Contact

Report a bug

Report a Snap Store violation

Share this snap

Generate an embeddable card to be shared on external websites.


Install headscale on your Linux distribution

Choose your Linux distribution to get detailed installation instructions. If yours is not shown, get more details on the installing snapd documentation.


Where people are using headscale

Users by distribution (log)

Ubuntu 24.04
Ubuntu 22.04
Debian 12
Ubuntu 20.04