shaananc / headscale

An open source implementation of the Tailscale coordination server

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

headscale

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
go build cmd/headscale/headscale.go 
  1. Get youself a PostgreSQL DB running.
docker run --name headscale -e POSTGRES_DB=headscale -e \
  POSTGRES_USER=foo -e POSTGRES_PASSWORD=bar -p 5432:5432 -d postgres
  1. Sort some stuff up (headscale Wireguard keys & the config.json file)
wg genkey > private.key
wg pubkey < private.key > public.key
cp config.json.example config.json
  1. Run it
./headcale
  1. Add your first machine
tailscale up -login-server YOUR_HEADSCALE_URL

About

An open source implementation of the Tailscale coordination server

License:BSD 3-Clause "New" or "Revised" License


Languages

Language:Go 55.1%Language:TypeScript 21.3%Language:Shell 7.9%Language:Dockerfile 5.3%Language:HTML 5.3%Language:CSS 2.9%Language:JavaScript 2.2%