Gatus

Automated developer-oriented status page with alerting and incident support.

Accessing Gatus

  • Ouvrez votre navigateur et rendez-vous sur : https://<SERVER_IP>
  • Un avertissement SSL du navigateur est à prévoir (certificat auto-signé)
  • Une authentification est requise (fenêtre contextuelle d'authentification de base)
  • Méthode d'authentification : HTTP Basic Auth
  • Les identifiants sont stockés en toute sécurité dans : /root/.cloudzy-creds

Fichiers et répertoires importants

  • Répertoire d'installation : /opt/gatus
  • Docker Compose : /opt/gatus/docker-compose.yml
  • Fichier environnement : /opt/gatus/.env
  • Config directory: /opt/gatus/config/
  • Fichier de configuration principal : /opt/gatus/config/config.yaml
  • Database directory: /opt/gatus/data/db
  • Configuration Nginx : /etc/nginx/sites-available/gatus.conf
  • Enabled Nginx site: /etc/nginx/sites-enabled/gatus.conf
  • Certificats SSL : /etc/nginx/ssl/
  • HTTP Basic Auth file: /etc/nginx/auth/.gatus-htpasswd
  • Fichier d'identification : /root/.gatus-credentials

Configuration Behavior

  • Configuration files are located in /opt/gatus/config/
  • YAML can be split into multiple files
  • Changes are auto-reloaded
  • No restart is required after edits

Gérer la pile

Accédez au répertoire d'installation :

cd /opt/gatus

Commandes courantes de Docker Compose :

# 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

Disable HTTP Basic Auth in Nginx (Optional)

Edit the Nginx site file: /etc/nginx/sites-available/gatus.conf

Remove or comment out these lines:

auth_basic "Restricted";
auth_basic_user_file /etc/nginx/auth/.gatus-htpasswd;

Recharger Nginx :

systemctl restart nginx

Activation du protocole SSL avec un domaine

1. Pointez votre domaine vers l'adresse IP du serveur.

2. Modifiez la configuration Nginx et remplacez les deux server_name <IP>; avec votre domaine (<your-domain>) pour 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. Exécutez 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. Remplacer les chemins SSL dans la configuration 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 modifications :

systemctl restart nginx

7. Ouvrez votre navigateur et rendez-vous sur : https://yourdomain.com

Détails de la demande