Waarom deze configuratie?
- Echte data-soevereiniteit: 100% AVG/GDPR compliant. Lokale gegevens en configuratie blijven op eigen hardware zonder cloud-afhankelijkheid.
- Hardware agnostisch: Geoptimaliseerd voor Raspberry Pi 5 (ARM64) en Proxmox VE hypervisors (x86_64 LXC & VM).
- Engine vrijheid: Getest en gevalideerd voor Docker CE en rootless Podman zonder root-privileges.
- Platform verificatie: Tested on Proxmox LXC: docker (stable, 2026-09-14), podman (stable, 2026-09-14); Proxmox VM: docker (stable, 2026-09-14), podman (stable, 2026-09-14).
Snelle Start (Standalone Docker Compose)
Onderstaand compose-fragment is direct te gebruiken in elke Docker- of Podman-omgeving:
services:
headscale:
image: "headscale/headscale:latest"
container_name: njorddeploy-headscale
command: serve
ports:
- "9080:8080"
volumes:
- "./data/headscale/data:/var/lib/headscale"
- "data_root/headscale/config.yaml:/etc/headscale/config.yaml:ro"
environment:
- "HEADSCALE_CONFIG=/etc/headscale/config.yaml"
- "TZ=Etc/UTC"
- "HEADSCALE_SERVER_URL=http://127.0.0.1:9080"
networks:
- njorddeploy_net
user: "0:0"
networks:
njorddeploy_net:
Start de service direct via de commandline: docker compose up -d
Configuratie & Omgevingsvariabelen
Belangrijkste configuratieparameters en standaardwaarden uit de NjordDeploy component-sjabloon:
| Variable | Default Value | Description |
|---|---|---|
HEADSCALE_WEB_PORT |
9080 |
The external port for Headscale's web UI and API. |
HOST_IP |
127.0.0.1 |
The IP address or domain name where Headscale is externally accessible. Used for the server_url in the configuration. |
TZ |
Etc/UTC |
Specify the timezone for the container (e.g., Europe/London, America/New_York). |
Ecosysteem & Bedrijfsintegratie
- Reverse Proxy Klaar: Direct te koppelen met Caddy, Traefik of Nginx Proxy Manager inclusief automatische Let's Encrypt TLS.
- Veilige Remote Toegang: Naadloos te combineren met WireGuard of Tailscale/Headscale voor veilige toegang buiten het lokale netwerk.
- Transactieve Back-ups: Geschikt voor point-in-time database dumps en container-safe volume snapshotting via NjordDeploy.
Eenvoudig beheren via NjordDeploy
Installeer, bewaak en update deze service met 1 klik op uw eigen Raspberry Pi of Proxmox server via de NjordDeploy Configurator.