Accessing Gatus
- Apri il browser e visita:
https://<SERVER_IP> - Un avviso SSL del browser è previsto (certificato self-signed)
- È richiesta l'autenticazione (popup Basic Auth)
- Metodo di autenticazione: HTTP Basic Auth
- Le credenziali sono salvate in modo sicuro in:
/root/.cloudzy-creds
File e directory importanti
- Install directory:
/opt/gatus - Docker Compose:
/opt/gatus/docker-compose.yml - Environment file:
/opt/gatus/.env - Config directory:
/opt/gatus/config/ - File di configurazione principale:
/opt/gatus/config/config.yaml - Database directory:
/opt/gatus/data/db - Nginx config:
/etc/nginx/sites-available/gatus.conf - Sito Nginx abilitato:
/etc/nginx/sites-enabled/gatus.conf - SSL certificates:
/etc/nginx/ssl/ - File Basic Auth di HTTP:
/etc/nginx/auth/.gatus-htpasswd - Credentials file:
/root/.gatus-credentials
Configuration Behavior
- I file di configurazione si trovano in
/opt/gatus/config/ - YAML può essere suddiviso in più file
- Le modifiche vengono ricaricate automaticamente
- Non è necessario riavviare dopo aver apportato modifiche
Gestisci lo stack
Go nella directory di installazione:
cd /opt/gatus
Comandi Docker Compose più comuni:
# 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
Disabilita il Basic Auth di HTTP in Nginx (facoltativo)
Modifica il file del sito Nginx: /etc/nginx/sites-available/gatus.conf
Rimuovi o commenta queste righe:
auth_basic "Restricted";
auth_basic_user_file /etc/nginx/auth/.gatus-htpasswd;
Reload Nginx:
systemctl restart nginx
Abilitare SSL con un dominio
1. Punta il tuo dominio all'IP del server.
2. Modifica la configurazione Nginx e sostituisci entrambi server_name <IP>; con il tuo dominio (<your-domain>) per i blocchi HTTP (porta 80) e HTTPS (porta 443):
vim /etc/nginx/sites-available/gatus.conf
3. Install Certbot:
apt install -y certbot python3-certbot-nginx
4. Esegui il seguente comando per generare un certificato Let's Encrypt valido:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Sostituisci i percorsi SSL nella configurazione 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. Riavvia Nginx per applicare le modifiche:
systemctl restart nginx
7. Apri il browser e visita: https://yourdomain.com
