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>
20 lines
896 B
Markdown
20 lines
896 B
Markdown
# Create a User and Pre-Auth Key
|
|
|
|
[← Back to README](../README.md)
|
|
|
|
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`):
|
|
|
|
```bash
|
|
export HEADSCALE_CONTAINER=headscale-headscale-1
|
|
```
|
|
|
|
```bash
|
|
docker exec -it "$HEADSCALE_CONTAINER" headscale -c /etc/headscale/config.yaml user create homelab
|
|
docker exec -it "$HEADSCALE_CONTAINER" headscale users list
|
|
docker exec -it "$HEADSCALE_CONTAINER" headscale preauthkeys create --user 1 --expiration 1h
|
|
```
|
|
|
|
Copy the printed key — you'll use it once on each device you join.
|
|
|
|
> **About `--expiration`:** it only limits the window in which the key can *register a new device*. Devices already joined stay authorized after the key expires. Use a longer expiration (e.g. `24h`) or `--reusable` when onboarding several devices.
|