Gatus openen
- Open je browser en bezoek:
https://<SERVER_IP> - Een SSL-waarschuwing in de browser is normaal (selfsigned certificaat)
- Authenticatie vereist (Basic Auth popup)
- Authenticatiemethode: HTTP Basic Auth
- Inloggegevens worden veilig opgeslagen in:
/root/.cloudzy-creds
Belangrijke bestanden en mappen
- Installatiemap:
/opt/gatus - Docker Compose:
/opt/gatus/docker-compose.yml - Environment-bestand:
/opt/gatus/.env - Configuratiemap:
/opt/gatus/config/ - Hoofdconfiguratiebestand:
/opt/gatus/config/config.yaml - Databasemap:
/opt/gatus/data/db - Nginx-config:
/etc/nginx/sites-available/gatus.conf - Nginx-site ingeschakeld:
/etc/nginx/sites-enabled/gatus.conf - SSL-certificaten:
/etc/nginx/ssl/ - HTTP Basic Auth-bestand:
/etc/nginx/auth/.gatus-htpasswd - Credentials bestand:
/root/.gatus-credentials
Configuratiegedrag
- Configuratiebestanden bevinden zich in
/opt/gatus/config/ - YAML kan worden opgesplitst in meerdere bestanden
- Wijzigingen worden automatisch herladen
- Na aanpassingen is geen herstart vereist
De stack beheren
Go naar de installatiemap:
cd /opt/gatus
Veelgebruikte Docker Compose-opdrachten:
# 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 uitschakelen (optioneel)
Bewerk het Nginx-sitebestand: /etc/nginx/sites-available/gatus.conf
Verwijder of commentarieer deze regels uit:
auth_basic "Restricted";
auth_basic_user_file /etc/nginx/auth/.gatus-htpasswd;
Nginx herladen:
systemctl restart nginx
SSL inschakelen met een domein
1. Wijs je domein naar het server-IP.
2. Pas de Nginx-config aan en vervang beide server_name <IP>; met je domein (<your-domain>) voor zowel de HTTP-blokken (poort 80) als de HTTPS-blokken (poort 443):
vim /etc/nginx/sites-available/gatus.conf
3. Installeer Certbot:
apt install -y certbot python3-certbot-nginx
4. Voer het volgende commando uit om een geldig Let's Encrypt-certificaat te genereren:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Vervang de SSL-paden in de Nginx-config:
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. Herstart Nginx om de wijzigingen door te voeren:
systemctl restart nginx
7. Open je browser en bezoek: https://yourdomain.com
