This repository provides a comprehensive setup for configuring Headscale with Caddy for reverse proxy and Headscale Admin web-apps for efficient management. The setup is based on the detailed guide available here.
- Docker Network Configuration: Easily set up a Docker network for seamless communication between containers.
- Caddy Integration: Secure and configure your Headscale instance with Caddy as the reverse proxy, including optional Basic Auth for additional security.
- Headscale Configuration: Customize your Headscale setup with a simple configuration file.
- Admin UIs: Two powerful admin UI projects (headscale-ui and headscale-admin) for managing your Headscale instance efficiently.
-
Create Docker Network:
docker network create reverseproxy-nw
-
Caddy Setup:
- Replace
domain
with your actual domain in theCaddyfile
. - Optionally, secure
/web
and/admin
paths with Basic Auth:Add your username and hashed password to thecaddy hash-password -p <password>
Caddyfile
.
- Replace
-
Headscale Setup:
- Update
config.yaml
with your domain details.
- Update
-
Admin UIs Configuration:
- Generate API keys for both admin UI projects:
docker exec headscale headscale apikeys create
- Use the generated API keys in the configurations of headscale-ui and headscale-admin.
- Generate API keys for both admin UI projects:
Feel free to contribute by opening issues or submitting pull requests. For major changes, please open an issue first to discuss what you would like to change.
This project is licensed under the MIT License.
Let me know if you need any more details or further adjustments!