This provides a Docker-based setup for Headscale with minimal manual configuration. The Docker image is built automatically via GitHub Actions.

On first start it:

* Generates config

* Creates a pre-auth key

* Allows a client to connect within a few minutes

For non-Docker setups, there is also a simple install script: hwdsl2/headscale-install

That script is intended for a one-command VPS setup. It installs and configures Headscale with sensible defaults.

This follows the same approach as some of my earlier projects (e.g. docker-ipsec-vpn-server, setup-ipsec-vpn), focusing on making things work out of the box with minimal maintenance.

I’ve also been experimenting with related projects in the same space:

* docker-wireguard

* docker-openvpn

Feedback is welcome, especially from others running Headscale.

Headscale already provides a docker container: https://hub.docker.com/r/headscale/headscale

Why would I use this from a total online stranger instead?