Adrian Gunnar Lauterer 898e678e8e | ||
---|---|---|
.. | ||
README.md | ||
configuration.nix | ||
hardware-configuration.nix | ||
routes.nix |
README.md
things to setup on new headscale server
setup nixos
- get nixos running (preferably 22.11 or later)
- get a way to paste the config file from this repo to /etc/nixos/configuration.nix (like over ssh)
domain provider
- setup domain and domain and domain with wildcard to point to new server ip.
- make sure any other domains that require this ingress points to it.
- create a api key or similar to fit in a file like this. https://go-acme.github.io/lego/dns
- create api kay file in /ver/lib/secrets/cert.secret, you can drop the \ and the last config line in the example from lego as this is not needed with nixos
setup tailscale headscale
- create a namespace in headscale.
- add tailscale to headscale with
sudo tailscale up --login-server https://vpn.example.domain
(could be localhost) - follow link in a browser, copy result command on this server, but replace USERNAME in --user USERNAME with namespace name (might be that headscale has updated and only uses namespaces as term now?)
- add all other clients needed to tailscale again with the same process
done
add a new remote or nated service
- add the machine running the service to the tailscale/headscale network like in install process
- get the headscale name with
headscale nodes list
- go to configuration.nix with vim or another editor
- add a virtual host to nginx for proxy, can copy one and change subdomain and proxy to machine + port, might remove basic auth if the service is intendend for everyone.
#Other solutions might end in the situation where nixos is not an option and docker containers with diffrent things is my backup solution. nothing is created yet but plan to use headscale with headscale-ui docker container in addition to something like nginxproxymanager,træfik or caddy. In this case use certbot or acme for certs i think.
NGINX alternative: Caddy seems promising with tailscale integrated in the future.
Tailscale/headscale alternative: plain wireguard, openvpn or