Headscale-WebUI

A simple Headscale web UI for small-scale deployments.

Screenshots | Installation | Issues

Features

1. Enable/Disable routes and exit nodes
   • Manage failover routes as well
2. Add, move, rename, and remove machines
3. Add and remove users/namespaces
4. Add and expire PreAuth keys
5. Add and remove machine tags
6. View machine details
   • Hostname
   • User associated with the machine
   • IP addresses in the Tailnet
   • Last seen by the control server
   • Last update with the control server
   • Creation date
   • Expiration date (will also display a badge when nearing expiration)
   • PreAuth key associated with the machine
   • Enable / disable routes and exit nodes
   • Add and delete machine tags
7. Basic and OIDC Authentication
   • OIDC Authentication tested with Authelia and Keycloak
8. Change your color theme! See MaterializeCSS Documentation for Colors for examples.
9. Search your machines and users.
   • Machines have tags you can use to filter search:
     • tag:tagname Searches only for specific tags
     • machine:machine-name Searches only for specific machines
     • user:user-name Searches only for specific users

Installation

• See SETUP.md for installation and configuration instructions.

Screenshots:

Tech used:

• Python - Link
• Poetry - Link
• MaterializeCSS - Link
• jQuery - Link

For Python libraries, see pyproject.toml

If you use this project, please reach out! It keeps me motivated! Thank you!