Skip to content

Runbook: Website Down

Symptoms

Uptime Kuma alert or user report — site returns 502/503/timeout.

Diagnosis

# 1. Check server reachability
ping {server_ip}

# 2. SSH in, check nginx
sudo systemctl status nginx

# 3. Check backend service
sudo systemctl status {service}

# 4. Check logs
journalctl -u {service} --since "30 min ago"

# 5. Check disk space
df -h

# 6. Check memory
free -h

Common Fixes

Problem Fix
Service crashed sudo systemctl restart {service}
Nginx config error sudo nginx -t then fix and reload
Disk full sudo journalctl --vacuum-size=100M
Port conflict sudo ss -tlnp \| grep {port}