mirror of
https://github.com/juanfont/headscale.git
synced 2025-10-10 11:14:24 +02:00
40e226c9ee
* Use the existing "Using headscale" sections and combine them into a single getting started guide with a little bit more explanation. * Explain how to get help from the command line client. * Remove duplicated sections from existing installation guides
61 lines
1.5 KiB
Markdown
61 lines
1.5 KiB
Markdown
# Running headscale on Linux
|
|
|
|
## Requirements
|
|
|
|
- Ubuntu 20.04 or newer, Debian 11 or newer.
|
|
|
|
## Goal
|
|
|
|
Get Headscale up and running.
|
|
|
|
This includes running Headscale with systemd.
|
|
|
|
## Migrating from manual install
|
|
|
|
If you are migrating from the old manual install, the best thing would be to remove
|
|
the files installed by following [the guide in reverse](./running-headscale-linux-manual.md).
|
|
|
|
You should _not_ delete the database (`/var/lib/headscale/db.sqlite`) and the
|
|
configuration (`/etc/headscale/config.yaml`).
|
|
|
|
## Installation
|
|
|
|
1. Download the [latest Headscale package](https://github.com/juanfont/headscale/releases/latest) for your platform (`.deb` for Ubuntu and Debian).
|
|
|
|
```shell
|
|
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"
|
|
```
|
|
|
|
1. Install Headscale:
|
|
|
|
```shell
|
|
sudo apt install ./headscale.deb
|
|
```
|
|
|
|
1. Enable Headscale service, this will start Headscale at boot:
|
|
|
|
```shell
|
|
sudo systemctl enable headscale
|
|
```
|
|
|
|
1. Configure Headscale by editing the configuration file:
|
|
|
|
```shell
|
|
nano /etc/headscale/config.yaml
|
|
```
|
|
|
|
1. Start Headscale:
|
|
|
|
```shell
|
|
sudo systemctl start headscale
|
|
```
|
|
|
|
1. Check that Headscale is running as intended:
|
|
|
|
```shell
|
|
systemctl status headscale
|
|
```
|