Files
huanld 0990478d9c
checklocks / checklocks (push) Has been cancelled
CodeQL / Analyze (go) (push) Has been cancelled
Dockerfile build / deploy (push) Has been cancelled
natlab-integrationtest / natlab-integrationtest (push) Has been cancelled
CI / gomod-cache (push) Has been cancelled
CI / fuzz (push) Has been cancelled
tailscale.com/cmd/vet / vet (push) Has been cancelled
update-flakehub / flakehub-publish (push) Has been cancelled
CI / race-root-integration (1/4) (push) Has been cancelled
CI / race-root-integration (2/4) (push) Has been cancelled
CI / race-root-integration (3/4) (push) Has been cancelled
CI / race-root-integration (4/4) (push) Has been cancelled
CI / test (-race, amd64, 1/3) (push) Has been cancelled
CI / test (-race, amd64, 2/3) (push) Has been cancelled
CI / test (-race, amd64, 3/3) (push) Has been cancelled
CI / test (386) (push) Has been cancelled
CI / test (amd64) (push) Has been cancelled
CI / Windows (benchmarks) (push) Has been cancelled
CI / Windows (1/2) (push) Has been cancelled
CI / Windows (2/2) (push) Has been cancelled
CI / macos (push) Has been cancelled
CI / privileged (push) Has been cancelled
CI / vm (push) Has been cancelled
CI / cross (386, linux) (push) Has been cancelled
CI / cross (amd64, darwin) (push) Has been cancelled
CI / cross (amd64, freebsd) (push) Has been cancelled
CI / cross (amd64, openbsd) (push) Has been cancelled
CI / cross (amd64, windows) (push) Has been cancelled
CI / cross (arm, 5, linux) (push) Has been cancelled
CI / cross (arm, 7, linux) (push) Has been cancelled
CI / cross (arm64, darwin) (push) Has been cancelled
CI / cross (arm64, linux) (push) Has been cancelled
CI / cross (arm64, windows) (push) Has been cancelled
CI / cross (loong64, linux) (push) Has been cancelled
CI / ios (push) Has been cancelled
CI / crossmin (amd64, illumos) (push) Has been cancelled
CI / crossmin (amd64, plan9) (push) Has been cancelled
CI / crossmin (amd64, solaris) (push) Has been cancelled
CI / crossmin (ppc64, aix) (push) Has been cancelled
CI / android (push) Has been cancelled
CI / wasm (push) Has been cancelled
CI / tailscale_go (push) Has been cancelled
CI / depaware (push) Has been cancelled
CI / go_generate (push) Has been cancelled
CI / make_tidy (push) Has been cancelled
CI / licenses (push) Has been cancelled
CI / staticcheck (macOS) (push) Has been cancelled
CI / staticcheck (Linux) (push) Has been cancelled
CI / staticcheck (Windows) (push) Has been cancelled
CI / staticcheck (Portable (1/4)) (push) Has been cancelled
CI / staticcheck (Portable (2/4)) (push) Has been cancelled
CI / staticcheck (Portable (3/4)) (push) Has been cancelled
CI / staticcheck (Portable (4/4)) (push) Has been cancelled
CI / notify_slack (push) Has been cancelled
CI / merge_blocker (push) Has been cancelled
CI / check_mergeability_strict (push) Has been cancelled
CI / check_mergeability (push) Has been cancelled
chore: release v1.0.0 including built MSI package
2026-04-22 03:39:08 -07:00
..
2026-04-10 17:44:15 +07:00

Headscale Web Admin

Web-based admin panel for managing Headscale VPN nodes, users, and pre-auth keys.

Features

  • Dashboard: Total nodes, online/offline count
  • Nodes: List, delete, expire nodes
  • Users: Create, delete users
  • Pre-auth Keys: Create reusable/ephemeral keys for auto-registration
  • Auto-refresh: Node status updates every 30s
  • Simple auth: Password-protected admin panel

Quick Start

# 1. Copy env file
cp .env.example .env

# 2. Edit .env with your Headscale API key
#    Generate key: docker exec headscale headscale apikeys create --expiration 365d

# 3. Start
docker compose up -d

Admin panel: http://your-server:9080

Standalone (without Headscale in same compose)

docker build -t headscale-admin .
docker run -d --name headscale-admin \
  -p 9080:9080 \
  -e HEADSCALE_URL=http://your-headscale:8080 \
  -e HEADSCALE_API_KEY=your_key \
  -e ADMIN_PASSWORD=your_password \
  headscale-admin

Environment Variables

Variable Required Default Description
HEADSCALE_URL Yes http://localhost:8080 Headscale API URL
HEADSCALE_API_KEY Yes - Headscale API key
ADMIN_PASSWORD No - Web UI password (empty = no auth)
LISTEN_ADDR No :9080 Listen address