mirror of
https://github.com/tale/headplane.git
synced 2026-07-26 15:58:14 +00:00
Aarnav Tale
84 lines
2.5 KiB
Markdown
84 lines
2.5 KiB
Markdown
# Headplane
|
|
|
|
> A feature-complete web UI for [Headscale](https://headscale.net)
|
|
|
|
<picture>
|
|
<source
|
|
media="(prefers-color-scheme: dark)"
|
|
srcset="./docs/assets/preview-dark.png"
|
|
>
|
|
<source
|
|
media="(prefers-color-scheme: light)"
|
|
srcset="./docs/assets/preview-light.png"
|
|
>
|
|
<img
|
|
alt="Preview"
|
|
src="./docs/assets/preview-dark.png"
|
|
>
|
|
</picture>
|
|
|
|
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](https://headplane.net) for detailed installation instructions.
|
|
|
|
## Versioning
|
|
|
|
Headplane uses [semantic versioning](https://semver.org/) 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](./docs/CONTRIBUTING.md) for more info.
|
|
|
|
---
|
|
|
|
<picture>
|
|
<source
|
|
media="(prefers-color-scheme: dark)"
|
|
srcset="./docs/assets/acls-dark.png"
|
|
>
|
|
<source
|
|
media="(prefers-color-scheme: light)"
|
|
srcset="./docs/assets/acls-light.png"
|
|
>
|
|
<img
|
|
alt="ACLs"
|
|
src="./docs/assets/acls-dark.png"
|
|
>
|
|
</picture>
|
|
|
|
<picture>
|
|
<source
|
|
media="(prefers-color-scheme: dark)"
|
|
srcset="./docs/assets/machine-dark.png"
|
|
>
|
|
<source
|
|
media="(prefers-color-scheme: light)"
|
|
srcset="./docs/assets/machine-light.png"
|
|
>
|
|
<img
|
|
alt="Machine Management"
|
|
src="./docs/assets/machine-dark.png"
|
|
>
|
|
</picture>
|
|
|
|
> Copyright (c) 2025 Aarnav Tale
|