A web frontend for the headscale Tailscale-compatible coordination server
Headscale-UI is a web frontend for the headscale Tailscale-compatible coordination server. It provides a user-friendly interface for users to manage their headscale server and coordinate various networking operations.
Headscale-UI is currently released as a static site. To install, simply download the release and host it with your preferred web server. It is recommended to serve Headscale-UI from the /web path to avoid any conflicts with the headscale server on the same domain. Please note that due to CORS, the headscale UI must be served on the same subdomain as the headscale server or have CORS headers injected via reverse proxy.
If you are using Docker, you can install headscale and headscale-ui together. Headscale UI serves on port 443 and uses a self-signed certificate by default. You will need to add a config.yaml file under your container-config folder to declare all the required settings for headscale. There is an example available in the official headscale repository.
Additionally, the Docker container allows you to customize settings such as HTTP port and HTTPS port by setting the corresponding variables.
To install headscale-ui on your domain, you will need a reverse proxy. An example Caddy Config is provided in the documentation to help you achieve this.
If you prefer not to configure headscale-ui on the same subdomain as headscale, you can intercept headscale traffic via your reverse proxy to fix CORS issues. Another example is provided using Caddy, replacing the headscale UI domain with hs-ui.yourdomain.com.au.
Please refer to the documentation for other configurations and proxy examples, such as Traefik.
Headscale-UI is a web frontend for the headscale coordination server. It provides a user-friendly interface for managing the headscale server and coordinating networking operations. Installation is straightforward, and there is support for both traditional hosting and Docker configurations. By following the troubleshooting guidelines, users can identify and resolve common issues. The product integrates well with popular web browsers and provides flexibility for customization through reverse proxies. Overall, Headscale-UI is a valuable tool for managing headscale servers efficiently.
