GitHub Repository

Docker image to run a Headscale server, a self-hosted, open-source Tailscale-compatible mesh VPN coordination server. Auto-generates config and pre-auth key on first start. MagicDNS support, helper script for user/node management. Multi-arch: amd64, arm64.

13 starsShell

Docker setup for Headscale (self-hosted Tailscale control server)

Name: Docker setup for Headscale (self-hosted Tailscale control server)
Availability: InStock
Author: hwdsl2

by hwdsl2·Apr 4, 2026·1 point·2 comments

Visit Project View on HN

AI Analysis

●MidCozyShip It

Convenience wrapper for Headscale when the official Docker image already exists.

Strengths

•Auto-generates config and reusable pre-auth keys on first container start
•Multi-arch support covers both amd64 and arm64 deployments
•hs_manage helper script simplifies user and node management

Weaknesses

•Headscale already has official Docker images and deployment docs
•No meaningful differentiation beyond convenience packaging

Post Description

This provides a Docker-based setup for Headscale with minimal manual configuration.

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.