Mirrors/juanfont.headscale
1
0
Fork 0
mirror of https://github.com/juanfont/headscale.git synced 2025-10-10 11:14:24 +02:00
Code Issues Projects Releases Wiki Activity
cbe2483d45
juanfont.headscale/docs/setup/install/official.md
Florian Preinstorfer cbe2483d45 Move deb install guide to official releases
2024-10-09 15:41:54 +02:00

1.5 KiB
Raw Blame History

Official releases

Official releases for headscale are available as binaries for various platforms and DEB packages for Debian and Ubuntu. Both are available on the GitHub releases page.

Using packages for Debian/Ubuntu (recommended)

It is recommended to use our DEB packages to install headscale on a Debian based system as those packages configure a user to run headscale, provide a default configuration and ship with a systemd service file. Supported distributions are Ubuntu 20.04 or newer, Debian 11 or newer.

  1. Download the latest Headscale package for your platform (.deb for Ubuntu and Debian).

    HEADSCALE_VERSION="" # See above URL for latest version, e.g. "X.Y.Z" (NOTE: do not add the "v" prefix!)
HEADSCALE_ARCH="" # Your system architecture, e.g. "amd64"
wget --output-document=headscale.deb \
  "https://github.com/juanfont/headscale/releases/download/v${HEADSCALE_VERSION}/headscale_${HEADSCALE_VERSION}_linux_${HEADSCALE_ARCH}.deb"

  2. Install Headscale:

    sudo apt install ./headscale.deb

  3. Configure Headscale by editing the configuration file:

    sudo nano /etc/headscale/config.yaml

  4. Enable and start the Headscale service:

    sudo systemctl enable --now headscale

  5. Check that Headscale is running as intended:

    sudo systemctl status headscale