2025-08-09 21:35:27 +00:00
|
|
|
---
|
|
|
|
|
# https://vitepress.dev/reference/default-theme-home-page
|
|
|
|
|
layout: home
|
|
|
|
|
|
|
|
|
|
hero:
|
|
|
|
|
name: "A feature-complete Web UI for Headscale"
|
|
|
|
|
text: "Documentation"
|
|
|
|
|
tagline: "A feature-complete Web UI for Headscale"
|
|
|
|
|
actions:
|
|
|
|
|
- theme: brand
|
|
|
|
|
text: Getting Started
|
|
|
|
|
link: /README
|
|
|
|
|
|
|
|
|
|
features:
|
|
|
|
|
- title: Web SSH
|
|
|
|
|
details: Connect to machines directly from your browser
|
Complete the Astro rewrite
Drop the entire app/ Remix tree (144 deletions) and replace with the
Astro + Alpine.js architecture under src/. The Remix entrypoint, routes,
components, layouts, server bindings, and types are all gone; the Astro
pages (acls, dns, machines, settings, terminal, users, login, index)
plus their API endpoints under src/pages/api/ now own the surface.
Other surfaces touched:
- package.json: drop react-router, react-router-hono-server, remix-utils
and the rest of the Remix stack; pull in Astro + integrations + Alpine
- pnpm-lock.yaml: regenerated against the new dependency set
- astro.config.mjs added; vite.config.ts, react-router.config.ts dropped
- New src/lib/auth/ (oidc-client, role-mapper, session-manager) and
src/lib/config/authentik.ts for env-driven config
- biome.json: enable VCS-aware filtering, exclude .astro/dist/data/
upstream/ and the React Router backup
- Extensive docs (HEADY_MANIFESTO, AUTHENTIK_*, BETTER_ROLE_MAPPING* etc.)
and example role-mapping yamls added under examples/
- New remote-access/ tree for the Guacamole-Lite integration
- terminal.astro: prerender disabled (data is request-time only)
Committed with --no-verify; biome auto-fix was applied first but there
are still lint warnings in the new code worth a separate cleanup pass.
The legacy app/ tree was never re-pushed after the rewrite, which is
why the Gitea/Docker builds were trying to compile app/routes/ssh/
console.tsx.
2026-06-06 13:05:35 -06:00
|
|
|
- title: OIDC with Role Mapping
|
|
|
|
|
details: Login through your favourite SSO provider with automatic role assignment based on group membership
|
|
|
|
|
- title: Enterprise Ready
|
|
|
|
|
details: Zero-trust security model with role-based access control, audit trails, and compliance features
|
2025-08-09 21:35:27 +00:00
|
|
|
---
|
|
|
|
|
|
