2020-06-21 03:21:07 -06:00
|
|
|
# headscale
|
2020-06-21 03:58:25 -06:00
|
|
|
An open source implementation of the Tailscale coordination server.
|
|
|
|
|
|
|
|
|
|
|
|
## Disclaimer
|
|
|
|
|
|
|
|
1. I have nothing to do with Tailscale, or Tailscale Inc. Just a fan of their tech.
|
|
|
|
2. The purpose of writing this was to learn a bit how Tailscale works. Hence the emojis in the log messages and other terrible code.
|
|
|
|
3. I don't use Headscale myself (their Solo plan + DERP infra is way more convenient).
|
|
|
|
4. Headscale adds all the machines under the same user. Be careful!
|
|
|
|
|
|
|
|
|
|
|
|
## Running it
|
|
|
|
|
|
|
|
1. Compile the headscale binary
|
2021-02-21 12:42:32 -07:00
|
|
|
```shell
|
2020-06-21 03:58:25 -06:00
|
|
|
go build cmd/headscale/headscale.go
|
|
|
|
```
|
|
|
|
|
|
|
|
2. Get youself a PostgreSQL DB running.
|
|
|
|
|
2021-02-21 12:42:32 -07:00
|
|
|
```shell
|
2020-06-21 03:58:25 -06:00
|
|
|
docker run --name headscale -e POSTGRES_DB=headscale -e \
|
|
|
|
POSTGRES_USER=foo -e POSTGRES_PASSWORD=bar -p 5432:5432 -d postgres
|
|
|
|
```
|
|
|
|
|
2020-06-21 04:32:08 -06:00
|
|
|
3. Sort some stuff up (headscale Wireguard keys & the config.json file)
|
2021-02-21 12:42:32 -07:00
|
|
|
```shell
|
2020-06-21 04:32:08 -06:00
|
|
|
wg genkey > private.key
|
2021-02-21 12:42:32 -07:00
|
|
|
wg pubkey < private.key > public.key # although not strictly needed
|
2020-06-21 04:32:08 -06:00
|
|
|
cp config.json.example config.json
|
|
|
|
```
|
|
|
|
|
2021-02-20 17:34:16 -07:00
|
|
|
4. Run the server
|
2021-02-21 12:42:32 -07:00
|
|
|
```shell
|
2021-02-20 17:34:16 -07:00
|
|
|
./headscale serve
|
2020-06-21 03:58:25 -06:00
|
|
|
```
|
|
|
|
|
2020-06-21 04:32:08 -06:00
|
|
|
5. Add your first machine
|
2021-02-21 12:42:32 -07:00
|
|
|
```shell
|
2020-06-21 03:58:25 -06:00
|
|
|
tailscale up -login-server YOUR_HEADSCALE_URL
|
|
|
|
```
|
2021-02-20 17:34:16 -07:00
|
|
|
|
|
|
|
6. Navigate to the URL you will get with `tailscale up`, where you can find your machine key.
|
|
|
|
|
|
|
|
7. Register your machine using the headscale CLI
|
2021-02-21 12:42:32 -07:00
|
|
|
```shell
|
2021-02-20 17:34:16 -07:00
|
|
|
./headscale register YOURMACHINEKEY
|
|
|
|
```
|