# gurucomputing/headscale-ui

A web frontend for the headscale Tailscale-compatible coordination server

Repository: https://github.com/gurucomputing/headscale-ui
Canonical: https://ross.abutalabs.com/products/headscale-ui
Language: Svelte
License: BSD-3-Clause
License Family: permissive
Topics: sveltekit, tailwindcss, vpn-service, web-frontend
Last push: 2026-03-16T19:37:30+00:00

## Health v2 (maintenance only)
Score: 74/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 72, release rhythm 63, longevity 100
- inputs: {"age_days": 1527, "days_push": 170, "days_rel": 170, "gap_med": 51.0, "n_releases_24m": 9}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2706, forks 199 (observed 2026-08-28T04:07:11.599990+00:00)

## What it is
Headscale-UI is a web frontend for the headscale Tailscale-compatible coordination server, built with SvelteKit and Tailwind CSS. It is distributed as a static site or Docker container and must be served on the same subdomain as headscale (or behind a CORS-fixing reverse proxy).

## Use cases
- manage headscale vpn nodes from a web interface
- web ui for headscale tailscale control server
- self-hosted tailscale admin dashboard
- view and manage tailnet machines and users
- docker web frontend for headscale

## When to choose
- you run headscale and want a graphical interface instead of the CLI
- you want a lightweight static frontend deployable via Docker or any web server
- you manage a self-hosted Tailscale-compatible network

## When to avoid
- you use official Tailscale rather than headscale
- you cannot serve the UI on the same subdomain as headscale or configure CORS via reverse proxy
- you need a full management API beyond what headscale exposes

## Facets
- artifact type: application
- maturity: active
- function: web-framework, ui-components, self-hosted
- domain: networking, self-hosted, web-development, privacy
- platform: self-hosted, cross-platform
- tags: headscale, tailscale, vpn, sveltekit, admin-ui, web-frontend, web-server, docker

## Member repositories
- gurucomputing/headscale-ui (main) score 74

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:11.599990+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:15:50.693151+00:00, confidence not recorded.
  - readme: https://github.com/gurucomputing/headscale-ui (fetched 2026-08-28T04:07:11.599990+00:00, sha 5759a828062e)
- Data as of 2026-08-30T08:39:29.467469+00:00.