Skip to content

Headscale Web UI

headplane

Setup

If Headscale is installed in Kubernetes, configure a shell alias:

alias headscale="kubectl -n headscale exec -it deployment/headscale -c headscale -- headscale"

Create an API key:

headscale apikeys create --expiration 5y

During first login enter the API key.

gurucomputing/headscale-ui

  • GitHub
  • Container images
  • Bundles in both headscale helm charts
    • Configures ingress for /web
  • Prometheus endpoint 127.0.0.1:9090/metrics
    • No real useful metrics

Configure gurucomputing/headscale-ui

Connect UI to headscale server:

kubectl -n headscale exec -it -c headscale headscale-6f4b745765-z9dpw -- \
  headscale apikeys create --expiration 3y
kubectl -n headscale exec -it -c headscale headscale-6f4b745765-z9dpw -- \
  headscale apikeys list

Server settings:

  • Headscale API Key: $(gopass show --password token/$HEADSCALE_DOMAIN/api-token)

gurucomputing/headscale-ui usage

New client:

Ionscale

Other web UIs