headscale/docs/setup/install/community.md
Florian Preinstorfer 8c09afe20c Headscale implements a single tailnet
Separate the term "tailnet" from user and be more explicit about
providing a single tailnet.

Also be more explicit about users. Refer to "headscale users" when
mentioning commandline invocations and use the term "local users" when
discussing unix accounts.

Fixes: #2335
2025-02-05 11:05:03 +01:00

1.8 KiB

Community packages

Several Linux distributions and community members provide packages for headscale. Those packages may be used instead of the official releases provided by the headscale maintainers. Such packages offer improved integration for their targeted operating system and usually:

  • setup a dedicated local user account to run headscale
  • provide a default configuration
  • install headscale as system service

!!! warning "Community packages might be outdated"

The packages mentioned on this page might be outdated or unmaintained. Use the [official releases](./official.md) to
get the current stable version or to test pre-releases.

[![Packaging status](https://repology.org/badge/vertical-allrepos/headscale.svg)](https://repology.org/project/headscale/versions)

Arch Linux

Arch Linux offers a package for headscale, install via:

pacman -S headscale

The AUR package headscale-git can be used to build the current development version.

Fedora, RHEL, CentOS

A third-party repository for various RPM based distributions is available at: https://copr.fedorainfracloud.org/coprs/jonathanspw/headscale/. The site provides detailed setup and installation instructions.

Nix, NixOS

A Nix package is available as: headscale. See the NixOS package site for installation details.

Gentoo

emerge --ask net-vpn/headscale

Gentoo specific documentation is available here.

OpenBSD

Headscale is available in ports. The port installs headscale as system service with rc.d and provides usage instructions upon installation.

pkg_add headscale