1
0
Fork 0
mirror of https://github.com/tale/headplane.git synced 2026-07-15 18:16:58 +00:00
A feature-complete Web UI for Headscale
Find a file
Aarnav Tale b3c0c1c691
fix(agent): always spawn agent with pre-auth key and auto-approve
- Generate a fresh pre-auth key for every agent startup
- Preserve existing tailscale state to avoid creating a new host
- Auto-approve pending auth requests via /api/v1/auth/approve
- Show approval link in settings UI as fallback

Closes HP-558
2026-07-13 11:00:43 -04:00
.devcontainer feat: update nodejs 22 references to 24 2026-03-17 13:24:55 -04:00
.github chore: add pullfrog.yml workflow 2026-06-17 10:26:20 -04:00
app fix(agent): always spawn agent with pre-auth key and auto-approve 2026-07-13 11:00:43 -04:00
cmd fix(agent): always spawn agent with pre-auth key and auto-approve 2026-07-13 11:00:43 -04:00
docs fix(agent): always spawn agent with pre-auth key and auto-approve 2026-07-13 11:00:43 -04:00
drizzle feat: add support for OIDC logouts 2026-04-26 20:36:52 -04:00
internal fix(agent): always spawn agent with pre-auth key and auto-approve 2026-07-13 11:00:43 -04:00
nix Fix wasm ssh in nix build (#588) 2026-07-12 18:18:48 -04:00
patches fix(wasm): account for custom DERP ports when checking the probe 2026-06-17 11:30:34 -04:00
public feat: rebuild browser ssh from the ground up 2026-04-09 21:56:42 -04:00
runtime feat: switch logging to pino 2026-06-17 15:58:48 -04:00
tests fix: treat Go pseudo-versions as unknown server versions (#590) 2026-07-12 18:18:21 -04:00
.dockerignore chore: switch to build script 2025-10-19 14:09:56 -04:00
.gitignore fix: patch tailscale to support a custom DERP port 2026-04-07 00:24:50 -04:00
.npmrc docs: deploy stable and beta docs 2026-04-11 14:32:21 -04:00
.oxfmtrc.json feat: switch to oxc linting/formatting 2026-01-15 22:09:58 -05:00
.oxlintrc.json feat: switch to oxc linting/formatting 2026-01-15 22:09:58 -05:00
AGENTS.md chore: update agents file 2026-03-14 11:50:19 -04:00
build.sh fix(wasm): account for custom DERP ports when checking the probe 2026-06-17 11:30:34 -04:00
Caddyfile chore: add tooling for go wasm 2025-06-16 11:45:23 -04:00
CHANGELOG.md fix(agent): always spawn agent with pre-auth key and auto-approve 2026-07-13 11:00:43 -04:00
compose.yaml chore(ssh): warn about broken SSH on certain versions 2026-07-01 11:23:35 -04:00
config.example.yaml feat(auth): support role sync on re-login 2026-06-22 16:40:29 -04:00
Dockerfile feat: gate the healthcheck listen file to docker only 2026-05-30 20:46:32 -04:00
drizzle.config.ts chore: format everything with oxfmt 2026-04-26 20:38:45 -04:00
flake.lock chore: update flake.lock (#545) 2026-05-27 20:37:47 -04:00
flake.nix feat: update nodejs 22 references to 24 2026-03-17 13:24:55 -04:00
go.mod fix: upgrade to new tailscale go version to fix ssh 2025-09-27 12:10:15 -04:00
go.sum fix: upgrade to new tailscale go version to fix ssh 2025-09-27 12:10:15 -04:00
lefthook.yml chore: update dev stuff 2026-06-22 16:40:29 -04:00
LICENSE chore: add license and readme again 2024-03-26 10:24:28 -04:00
mise.toml feat: upgrade to node 24 and drizzle 2026-03-17 13:22:48 -04:00
package.json chore: v0.7.0 2026-07-04 11:10:57 -04:00
pnpm-lock.yaml chore: add audit fix 2026-06-22 16:42:10 -04:00
react-router.config.ts chore: update to react router v8 2026-06-20 13:33:24 -04:00
README.md chore: format everything with oxfmt 2026-04-26 20:38:45 -04:00
tsconfig.json docs: deploy stable and beta docs 2026-04-11 14:32:21 -04:00
vite.config.ts chore: update to react router v8 2026-06-20 13:33:24 -04:00
vitest.config.ts feat: add support for headscale 0.29+ 2026-06-20 18:03:14 -04:00

Headplane

A feature-complete web UI for Headscale

Preview

Headscale is the de-facto self-hosted version of Tailscale, a popular Wireguard based VPN service. By default, it does not ship with a web UI, which is where Headplane comes in. Headplane is a feature-complete web UI for Headscale, allowing you to manage your nodes, networks, and ACLs with ease.

Headplane aims to replicate the functionality offered by the official Tailscale product and dashboard, being one of the most feature complete Headscale UIs available. These are some of the features that Headplane offers:

  • Machine management, including expiry, network routing, name, and owner management
  • Access Control List (ACL) and tagging configuration for ACL enforcement
  • Support for OpenID Connect (OIDC) as a login provider
  • The ability to edit DNS settings and automatically provision Headscale
  • Configurability for Headscale's settings

Deployment

Refer to the website for detailed installation instructions.

Versioning

Headplane uses semantic versioning for its releases (since v0.6.0). Pre-release builds are available under the next tag and get updated when a new release PR is opened and actively in testing.

Contributing

Headplane is an open-source project and contributions are welcome! If you have any suggestions, bug reports, or feature requests, please open an issue. Also refer to the contributor guidelines for more info.


ACLs Machine Management

Copyright (c) 2025 Aarnav Tale