Repolode
Submit
tale

tale/headplane

A web UI for managing self-hosted Headscale servers, covering nodes, ACLs, DNS and Headscale settings.

Open-source alternative to:Tailscale

View on GitHubWebsite
Stars
3,200
Forks
255
Open issues
40
Last commit
2 days ago

What is it?

Headscale is a self-hosted, open-source implementation of the Tailscale control server, but it ships without a graphical interface. Headplane fills that gap as a web dashboard for Headscale, letting administrators manage machines, networks and access policies from a browser instead of the command line.

The project aims to match the functionality of the official Tailscale dashboard. It covers machine management such as expiry, network routing, naming and ownership, along with Access Control List (ACL) editing and tag-based ACL enforcement. It also supports OpenID Connect (OIDC) for login, lets you edit DNS settings and provision Headscale, and exposes Headscale's configuration options.

Headplane is written in TypeScript and is designed to be deployed alongside an existing Headscale instance. Pre-release builds are published under a next tag, and releases follow semantic versioning from v0.6.0 onward.

Key features

  • 01Manage machine expiry, routes, names and owners
  • 02Edit ACLs and apply tag-based access control
  • 03Log in via OpenID Connect (OIDC)
  • 04Edit DNS settings and provision Headscale
  • 05Adjust Headscale configuration from the UI

Use cases

  • Running a self-hosted Tailscale-style VPN without using the command line for daily administration
  • Managing device access and ACL policies for a small team or homelab network
  • Providing SSO-based login to a Headscale admin dashboard via an existing OIDC provider

Quick start

  1. 1

    Read the installation instructions on the project website

  2. 2

    Follow the deployment guide at headplane.net to install and run Headplane

Things to know

  • Requires an existing Headscale server, as it is only a web UI for Headscale.
  • Deployment details are only in the external website, not in the README.

In collections

Self-hosted apps

Topics

#headscale#tailscale#vpn#wireguard#self-hosted#web-ui#acl#oidc#react

FAQ

What is headplane?
A web UI for managing self-hosted Headscale servers, covering nodes, ACLs, DNS and Headscale settings. Headscale is a self-hosted, open-source implementation of the Tailscale control server, but it ships without a graphical interface. Headplane fills that gap as a web dashboard for Headscale, letting administrators manage machines, networks and access policies from a browser instead of the command line.
Is headplane free to use? What license does it have?
headplane is open source under the MIT license. Check the license terms before using it in commercial products.
Is headplane still maintained?
Actively maintained. The last commit to headplane was on Oct 22, 2026.
What can I use headplane for?
Running a self-hosted Tailscale-style VPN without using the command line for daily administration Managing device access and ACL policies for a small team or homelab network Providing SSO-based login to a Headscale admin dashboard via an existing OIDC provider
How do I install headplane?
Read the installation instructions on the project website Follow the deployment guide at headplane.net to install and run Headplane
Where can I get headplane?
The source code and installation instructions are on GitHub: https://github.com/tale/headplane

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects