Auf Gatus zugreifen
- Öffnen Sie Ihren Browser und besuchen Sie:
https://<SERVER_IP> - Eine SSL-Warnung im Browser 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
- Installationsverzeichnis:
/opt/gatus - Docker Compose:
/opt/gatus/docker-compose.yml - Environment-Datei:
/opt/gatus/.env - Konfigurationsverzeichnis:
/opt/gatus/config/ - Haupt-Konfigurationsdatei:
/opt/gatus/config/config.yaml - Datenbankverzeichnis:
/opt/gatus/data/db - Nginx-Konfiguration:
/etc/nginx/sites-available/gatus.conf - Aktivierte Nginx-Site:
/etc/nginx/sites-enabled/gatus.conf - SSL-Zertifikate:
/etc/nginx/ssl/ - HTTP Basic-Auth-Datei:
/etc/nginx/auth/.gatus-htpasswd - Anmeldedaten-Datei:
/root/.gatus-credentials
Konfigurationsverhalten
- 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;
Nginx neu laden:
systemctl restart nginx
SSL mit einer Domain aktivieren
1. Richten Sie Ihre Domain auf die Server-IP aus.
2. Nginx-Konfiguration bearbeiten und beide ersetzen server_name <IP>; mit Ihrer Domain (<your-domain>) für beide Blöcke HTTP (Port 80) und HTTPS (Port 443):
vim /etc/nginx/sites-available/gatus.conf
3. Certbot installieren:
apt install -y certbot python3-certbot-nginx
4. Führen Sie folgenden Befehl aus, um ein gültiges Let’s Encrypt-Zertifikat zu erzeugen:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. SSL-Pfade in der Nginx-Konfiguration ersetzen:
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. Nginx neu starten, um die Änderungen anzuwenden:
systemctl restart nginx
7. Öffnen Sie Ihren Browser und besuchen Sie: https://yourdomain.com
