Accéder à Gatus
- Ouvrez votre navigateur et allez sur :
https://<SERVER_IP> - Un avertissement SSL du navigateur est attendu (certificat auto-signé)
- Authentification requise (fenêtre Basic Auth)
- Méthode d'authentification : Basic Auth HTTP
- Les identifiants sont stockés de façon sécurisée dans :
/root/.cloudzy-creds
Fichiers et répertoires importants
- Répertoire d'installation :
/opt/gatus - Docker Compose :
/opt/gatus/docker-compose.yml - Fichier d'environnement :
/opt/gatus/.env - Répertoire de configuration :
/opt/gatus/config/ - Fichier de configuration principal :
/opt/gatus/config/config.yaml - Répertoire de la base de données :
/opt/gatus/data/db - Config Nginx :
/etc/nginx/sites-available/gatus.conf - Site Nginx activé :
/etc/nginx/sites-enabled/gatus.conf - Certificats SSL :
/etc/nginx/ssl/ - Fichier Basic Auth HTTP :
/etc/nginx/auth/.gatus-htpasswd - Fichier de credentials :
/root/.gatus-credentials
Comportement de la configuration
- Les fichiers de configuration sont situés dans
/opt/gatus/config/ - YAML peut être réparti en plusieurs fichiers
- Les modifications sont rechargées automatiquement
- Aucun redémarrage nécessaire après modification
Gérer la stack
Go vers le répertoire d'installation :
cd /opt/gatus
Commandes Docker Compose courantes :
# 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
Désactiver l'authentification basique HTTP dans Nginx (optionnel)
Modifier le fichier de site Nginx : /etc/nginx/sites-available/gatus.conf
Supprimer ou commenter ces lignes :
auth_basic "Restricted";
auth_basic_user_file /etc/nginx/auth/.gatus-htpasswd;
Recharger Nginx :
systemctl restart nginx
Activer SSL avec un domaine
1. Faites pointer votre domaine vers l'IP du serveur.
2. Modifiez la config Nginx et remplacez les deux server_name <IP>; avec votre domaine (<your-domain>) dans les blocs HTTP (port 80) et HTTPS (port 443) :
vim /etc/nginx/sites-available/gatus.conf
3. Installez Certbot :
apt install -y certbot python3-certbot-nginx
4. Lancez la commande suivante pour générer un certificat Let's Encrypt valide :
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Remplacez les chemins SSL dans la config Nginx :
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. Redémarrez Nginx pour appliquer les changements :
systemctl restart nginx
7. Ouvrez votre navigateur et allez sur : https://yourdomain.com
