cyrius44/wireguard-ui
A web user interface to manage your WireGuard setup.
Image
Networking
Security
0
3.0K
cyrius44/wireguard-ui repository overview
WireGuard UI
Interface web pour administrer un serveur WireGuard sans manipuler directement les fichiers de configuration.
✨ Fonctionnalités
- Gestion des pairs (création, édition, révocation).
- Génération de configuration client.
- Export via QR code et fichier.
- Authentification administrateur.
- Healthcheck API intégré (
/api/health). - Déploiement simple avec Docker / Docker Compose.
- Envoie de mail pour l'enrollement
🚀 Démarrage rapide
Docker CLI
docker run -d \
--name wireguard-ui \
-p 8000:8000 \
-p 51820:51820 \
-e ADMIN_USERNAME=admin \
-e ADMIN_PASSWORD=yourpassword \
-e SECRET_KEY=your-secret-key \
-v /wireguard_data:/data \
cyrius44/wireguard-ui:latest
Open http://localhost:8080 and log in with your admin credentials.
Docker Compose
services:
portalcrane:
image: cyrius44/wireguard-ui:latest
container_name: wireguard-ui
ports:
- "8000:8000"
- "51820:51820"
environment:
- ADMIN_USERNAME=admin
- ADMIN_PASSWORD=changeme
- SECRET_KEY=your-secret-key
volumes:
- wireguard_data:/data
restart: unless-stopped
volumes:
wireguard_data:
Screeenshot
🧱 Stack technique
| Layer | Technology |
|---|---|
| Frontend | Angular 21 — Signals, Signal Forms, Zoneless, standalone components |
| Styling | Bootstrap 5 + Bootstrap Icons |
| Backend | FastAPI + Python 3.14 (fully async) |
| Validation | Pydantic v2 |
| Container | Single image — supervisord orchestrates all processes |
| Platforms | linux/amd64, linux/arm64 (Raspberry Pi, Apple Silicon) |
More informations
Tag summary
Content type
Image
Digest
sha256:53874c337…
Size
111 MB
Last updated
2 months ago
docker pull cyrius44/wireguard-ui