Please adjust the docker-compose.yml
as well as config.yaml
and adjust the example.com
domain name. Also put the provided config.yaml
into the corresponding config bind volume mount.
Afterwards spawn the container stack with docker compose up
and visit https://<your-domain>.<tld>/web
You must configure an API key in order to access and manage your headscale server.
You can create those using docker exec:
# create an api key
docker exec headscale headscale apikeys create
Afterwards, your headscale server should be managable.
- Create a new user account on your headscale web interface
- Download the official tailscale clients and spawn up tailscale pointing to your custom headscale login server. You'll obtain a unique device key or register url.
- Browse the device view at your headscale web interface and create a new device. Select your previously created user account and define the previously obtained device key from the tailscale client.
- If registering the new device was successful, the tailscale client will automatically connect. Enjoy!
Note: You may use preauth keys instead to skip the device registering process. Read the official headscale documentation please.
# connect via linux tailscale client
sudo tailscale up --login-server https://headscale.example.com