---
title: Install headscale on Linux | Snap Store
description: Get the latest version of headscale for Linux - An open source, self-hosted
  implementation of the Tailscale control server
url: https://snapcraft.io/headscale
---

# headscale

[Canonical](https://snapcraft.io/publisher/canonical "View all snaps from Canonical")

* [Canonical](https://snapcraft.io/publisher/canonical "View all snaps from Canonical")
* [Utilities](https://snapcraft.io/search?categories=utilities)

0.27/stable 0.27.1

Install 0.27/stable of headscale

---

**Install using the command line**

```
sudo snap install headscale
```

Don't have snapd? [Get set up for snaps](https://snapcraft.io/docs/installing-snapd).

---

### Package name

* headscale

---

### License

* BSD-3-Clause

---

### Last updated

* 29 January 2026 - 0.27/stable
* 15 October 2026 - 0.29/edge

---

### Contact

* [solutions-engineering@lists.canonical.com](mailto:solutions-engineering@lists.canonical.com "mailto:solutions-engineering@lists.canonical.com")

---

### Report a bug

* [github.com/canonical/headscale-snap/issues](https://github.com/canonical/headscale-snap/issues "https://github.com/canonical/headscale-snap/issues")

---

##### Report a Snap Store violation

* [Report this Snap](https://snapcraft.io/headscale#report-snap-modal)

---

* [Description](https://snapcraft.io/headscale#tab-description)
* [Security](https://snapcraft.io/headscale#tab-security)

#### 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.

---

## 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](https://snapcraft.io/docs/installing-snapd).

[### Arch Linux](https://snapcraft.io/install/headscale/arch)

[### CentOS](https://snapcraft.io/install/headscale/centos)

[### Debian](https://snapcraft.io/install/headscale/debian)

[### elementary OS](https://snapcraft.io/install/headscale/elementary)

[### Fedora](https://snapcraft.io/install/headscale/fedora)

[### KDE Neon](https://snapcraft.io/install/headscale/kde-neon)

[### Kubuntu](https://snapcraft.io/install/headscale/kubuntu)

[### Manjaro](https://snapcraft.io/install/headscale/manjaro)

[### Pop!\_OS](https://snapcraft.io/install/headscale/pop)

[### openSUSE](https://snapcraft.io/install/headscale/opensuse)

[### Red Hat Enterprise Linux](https://snapcraft.io/install/headscale/rhel)

[### Ubuntu](https://snapcraft.io/install/headscale/ubuntu)

[### Raspberry Pi](https://snapcraft.io/install/headscale/raspbian)