mirror of
https://github.com/nickyeoman/docker-compose-cookbooks.git
synced 2026-10-22 20:16:22 +00:00
Move step-by-step guides into headscale/docs/, slim README to a quick reference, and use $HEADSCALE_CONTAINER for docker exec commands. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1.4 KiB
1.4 KiB
Connect Phone / Laptop
Commands below use $HEADSCALE_CONTAINER. Set it once per shell session on the dedicated server (change the value if your compose project name differs; find it with docker ps):
export HEADSCALE_CONTAINER=headscale-headscale-1
Android / iOS
- Install the Tailscale app (Play Store / App Store).
- Point it at your server:
- Android (tested on v1.102.3, Galaxy S25 Ultra): Settings → Add account, tap the three-dot menu (⋮), choose the alternate/custom coordination server option, enter
https://headscale.example.com. - iOS: on the sign-in screen, choose Alternate coordination server before logging in.
- Android (tested on v1.102.3, Galaxy S25 Ultra): Settings → Add account, tap the three-dot menu (⋮), choose the alternate/custom coordination server option, enter
- Log in. If the app shows a registration key instead of accepting a pre-auth key, approve it on the dedicated server:
docker exec -it "$HEADSCALE_CONTAINER" headscale nodes register --user homelab --key <KEY-FROM-DEVICE>
Laptop / Desktop
Install the client (https://tailscale.com/download), then either use a pre-auth key:
sudo tailscale up --login-server=https://headscale.example.com --authkey <YOUR-PREAUTH-KEY>
Or approve interactively:
sudo tailscale up --login-server=https://headscale.example.com
# copy the printed key, then on the dedicated server:
docker exec -it "$HEADSCALE_CONTAINER" headscale nodes register --user homelab --key <KEY-FROM-DEVICE>