personal_interest_mirrors/Compose-Examples
1
0
Fork 0
mirror of https://github.com/Haxxnet/Compose-Examples.git synced 2026-02-15 09:14:25 +01:00
Code Issues Actions Packages Projects Releases Wiki Activity

add headscale

Browse Source
This commit is contained in:
LRVT
2024-01-11 23:44:02 +01:00
parent adb9b37282
commit 26b65fc5b5
4 changed files with 351 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

34
examples/headscale/README.md Normal file
View File

@@ -0,0 +1,34 @@
# References
- https://headscale.net/running-headscale-container/
- https://github.com/juanfont/headscale
# Notes
Please adjust the `docker-compose.yml` as well as `config.yaml` and adjust the `example.com` domain name.
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.
1. Create a new user account on your headscale web interface
2. 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.
3. 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.
4. 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
````