A simple Headscale web UI for small-scale deployments.

iFargle iFargle Last update: Feb 01, 2024

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:

Overview Routes Machines Users Settings


Tech used:

For Python libraries, see pyproject.toml

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

Subscribe to our newsletter