Acceder a Gatus
- Abre tu navegador y visita:
https://<SERVER_IP> - Es normal ver un aviso de SSL en el navegador (certificado autofirmado)
- Se requiere autenticación (ventana emergente de Basic Auth)
- Método de autenticación: HTTP Basic Auth
- Las credenciales se almacenan de forma segura en:
/root/.cloudzy-creds
Archivos y directorios importantes
- Directorio de instalación:
/opt/gatus - Docker Compose:
/opt/gatus/docker-compose.yml - Fichero de entorno:
/opt/gatus/.env - Directorio de configuración:
/opt/gatus/config/ - Archivo de configuración principal:
/opt/gatus/config/config.yaml - Directorio de la base de datos:
/opt/gatus/data/db - Configuración de Nginx:
/etc/nginx/sites-available/gatus.conf - Sitio Nginx habilitado:
/etc/nginx/sites-enabled/gatus.conf - Certificados SSL:
/etc/nginx/ssl/ - Archivo Basic Auth de HTTP:
/etc/nginx/auth/.gatus-htpasswd - Archivo de credenciales:
/root/.gatus-credentials
Comportamiento de la configuración
- Los archivos de configuración se encuentran en
/opt/gatus/config/ - YAML puede dividirse en varios archivos
- Los cambios se recargan automáticamente
- No se requiere reinicio tras editar
Gestionar el stack
Go al directorio de instalación:
cd /opt/gatus
Comandos habituales 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
Desactivar la autenticación básica de HTTP en Nginx (opcional)
Editar el archivo de sitio de Nginx: /etc/nginx/sites-available/gatus.conf
Eliminar o comentar estas líneas:
auth_basic "Restricted";
auth_basic_user_file /etc/nginx/auth/.gatus-htpasswd;
Recarga Nginx:
systemctl restart nginx
Habilitar SSL con un dominio
1. Apunta tu dominio a la IP del servidor.
2. Edita la configuración de Nginx y reemplaza los dos server_name <IP>; con tu dominio («<your-domain>) para los bloques HTTP (puerto 80) y HTTPS (puerto 443):
vim /etc/nginx/sites-available/gatus.conf
3. Instala Certbot:
apt install -y certbot python3-certbot-nginx
4. Ejecuta el siguiente comando para generar un certificado Let's Encrypt válido:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Reemplaza las rutas SSL en la configuración de 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. Reinicia Nginx para aplicar los cambios:
systemctl restart nginx
7. Abre el navegador y visita: https://yourdomain.com
