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

[Canonical Snapcraft](https://snapcraft.io/)

# Install headscale on **Kubuntu**

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

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

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

### 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/install/headscale/kubuntu#report-snap-modal)

---

## Enable snaps on Kubuntu and install headscale

Snaps are applications packaged with all their dependencies to run on all popular Linux distributions from a single build. They update automatically and roll back gracefully.

Snaps are discoverable and installable from the [Snap Store](https://snapcraft.io/store), an app store with an audience of millions.

### Enable snapd

If you’re running [Kubuntu 16.04 LTS (Xenial Xerus)](https://kubuntu.org/) or later, including [Kubuntu 18.04 LTS (Bionic Beaver)](https://wiki.ubuntu.com/BionicBeaver/ReleaseNotes/Kubuntu) and [Kubuntu 18.10 (Cosmic Cuttlefish)](https://wiki.ubuntu.com/CosmicCuttlefish/ReleaseNotes/Kubuntu), you don’t need to do anything. Snap is already installed and ready to go.

Versions of Kubuntu between [14.04 LTS (Trusty Tahr)](https://kubuntu.org/news/kubuntu-14-04-lts) and [15.10 (Wily Werewolf)](https://kubuntu.org/news/kubuntu-15-10) don’t include *snap* by default, but *snap* can be installed from the command line as follows:

```
sudo apt update
sudo apt install snapd
```

### Install headscale

To install headscale, simply use the following command:

```
sudo snap install headscale
```

### Other popular snaps…

[See more...](https://snapcraft.io/search?categories=featured)

[See more in Featured](https://snapcraft.io/search?categories=featured)

### More things to do…

#### [Get the snap store](https://snapcraft.io/snap-store)

Browse and find snaps from the convenience of your desktop using the snap store snap.

#### [Learn more about snaps](https://snapcraft.io/docs)

Interested to find out more about snaps? Want to publish your own application? Visit [snapcraft.io](https://snapcraft.io/) now.

[Back to top](https://snapcraft.io/install/headscale/kubuntu)

© 2026 Canonical Ltd.
Ubuntu and Canonical are registered trademarks of Canonical Ltd.

Powered by [Charmed Kubernetes](https://www.ubuntu.com/kubernetes)

[Join the forum](https://forum.snapcraft.io/), contribute to or report problems with,
[snapd](https://bugs.launchpad.net/snapd),
[Snapcraft](https://bugs.launchpad.net/snapcraft),
or [this site](https://github.com/canonical/snapcraft.io/issues/new).

* [Share on Twitter](https://twitter.com/snapcraftio)
* [Share on Facebook](https://www.facebook.com/snapcraftio)
* [Share on YouTube](https://www.youtube.com/snapcraftio)

* [Terms of Service](https://ubuntu.com/legal/terms-and-policies/snap-store-terms)
* [Data privacy](https://www.ubuntu.com/legal/data-privacy)
* [Manage your tracker settings](https://snapcraft.io/install/headscale/kubuntu)
* [Service status](https://status.snapcraft.io/)
* [Other functions](https://dashboard.snapcraft.io/)
* [Contact us](https://snapcraft.io/about/contact-us)