Files
headscale-webui/README.md
Adrian T c00f282e84 Removed "!" in the frameworks used
The links provided such as python.org aren't image URLs so GitHub tries to display them as images and clicking them doesn't work.
2023-03-15 21:28:36 -04:00

66 lines
2.0 KiB
Markdown

<p align="center">
<a href="https://github.com/juanfont/headscale">
<img src="static/img/headscale3-dots.png" width="250">
</a>
</p>
<h2 align="center">Headscale-WebUI</h3>
<p align="center">
A simple Headscale web UI for small-scale deployments.
</p>
<p align="center">
<a href="#Screenshots">Screenshots</a> | <a href="SETUP.md">Installation</a> | <a href="https://github.com/iFargle/headscale-webui/issues">Issues</a>
</p>
---
# Features
1. Enable/Disable routes and exit nodes
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
8. Change your color theme! See MaterializeCSS Documentation for Colors for examples.
---
# Installation
* See [SETUP.md](SETUP.md) for installation and configuration instructions.
---
# Screenshots:
Overview Page:
![Overview](screenshots/oidc_overview.png)
Users Page:
![Users](screenshots/users.png)
Machine Information:
![Add a new machine](screenshots/machines_expanded.png)
Machines Page:
![Machine Details](screenshots/machines.png)
Settings Page showing an API Key Test:
![API Key Test](screenshots/settings.png)
---
# Tech used:
* Python - [Link](https://www.python.org/)
* Poetry - [Link](https://python-poetry.org/)
* MaterializeCSS - [Link](https://github.com/Dogfalo/materialize)
* jQuery - [Link](https://jquery.com/)
For Python libraries, see [pyproject.toml](pyproject.toml)
If you use this project, please reach out! It keeps me motivated! Thank you!