Accessing Gatus
- Browser öffnen und aufrufen:
https://<SERVER_IP> - Eine Browser-SSL-Warnung ist zu erwarten (selbstsigniertes Zertifikat)
- Authentifizierung erforderlich (Basic Auth-Popup)
- Authentifizierungsmethode: HTTP Basic Auth
- Zugangsdaten werden sicher gespeichert in:
/root/.cloudzy-creds
Wichtige Dateien und Verzeichnisse
- Install directory:
/opt/gatus - Docker Compose:
/opt/gatus/docker-compose.yml - Environment file:
/opt/gatus/.env - Config directory:
/opt/gatus/config/ - Haupt-Konfigurationsdatei:
/opt/gatus/config/config.yaml - Database directory:
/opt/gatus/data/db - Nginx config:
/etc/nginx/sites-available/gatus.conf - Aktivierte Nginx-Site:
/etc/nginx/sites-enabled/gatus.conf - SSL certificates:
/etc/nginx/ssl/ - HTTP Basic-Auth-Datei:
/etc/nginx/auth/.gatus-htpasswd - Credentials file:
/root/.gatus-credentials
Configuration Behavior
- Konfigurationsdateien befinden sich in
/opt/gatus/config/ - YAML kann auf mehrere Dateien aufgeteilt werden
- Änderungen werden automatisch neu geladen
- Nach Änderungen ist kein Neustart erforderlich
Den Stack verwalten
Go in das Installationsverzeichnis:
cd /opt/gatus
Häufige Docker-Compose-Befehle:
# Check status
docker compose ps
# View logs (follow live)
docker compose logs -f
# Restart all services
docker compose restart
# Stop services
docker compose down
# Start again
docker compose up -d
HTTP Basic Auth in Nginx deaktivieren (optional)
Die Nginx-Sitedatei bearbeiten: /etc/nginx/sites-available/gatus.conf
Diese Zeilen entfernen oder auskommentieren:
auth_basic "Restricted";
auth_basic_user_file /etc/nginx/auth/.gatus-htpasswd;
Reload Nginx:
systemctl restart nginx
SSL mit einer Domain aktivieren
1. Weise deiner Domain die Server-IP zu.
2. Nginx-Konfiguration bearbeiten und beide ersetzen server_name <IP>; mit Ihrer Domain (<your-domain>) für sowohl HTTP (Port 80) als auch HTTPS (Port 443) Blöcke:
vim /etc/nginx/sites-available/gatus.conf
3. Install Certbot:
apt install -y certbot python3-certbot-nginx
4. Führe folgenden Befehl aus, um ein gültiges Let's Encrypt-Zertifikat zu generieren:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Ersetze SSL-Pfade in der Nginx-Konfiguration:
vim /etc/nginx/sites-available/gatus.conf
# Before:
# ssl_certificate /etc/nginx/ssl/fullchain.pem;
# ssl_certificate_key /etc/nginx/ssl/privkey.pem;
# After:
# ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
# ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
6. Starte NGINX neu, um die Änderungen zu übernehmen:
systemctl restart nginx
7. Öffne deinen Browser und rufe folgende Adresse auf: https://yourdomain.com
