Incident checklist

Primo controllo

obelica status
obelica doctor
docker compose ls
docker ps
ss -tulpen
df -h /
free -h

Se un sito non risponde

1. Verificare DNS.

obelica dns dominio.example
dig +short dominio.example

2. Verificare Traefik.

cd /opt/obelica/infra/traefik
docker compose ps
docker compose logs --tail=200

3. Verificare app.

cd /opt/obelica/apps/<app-name>
docker compose ps
docker compose logs --tail=200

4. Verificare HTTPS.

curl -Iv https://dominio.example

Se Forgejo non risponde

cd /opt/obelica/infra/forgejo
docker compose ps
docker compose logs --tail=200 forgejo
docker compose logs --tail=200 forgejo-db
curl -I http://127.0.0.1:3333
docker exec forgejo-db psql -U forgejo -d forgejo -tAc 'select 1;'

Se il disco cresce

df -h /
du -h -d 2 /opt/obelica 2>/dev/null
docker system df

Non cancellare dati sotto /opt/obelica/data senza backup e decisione esplicita.

Dopo risoluzione

• Annotare causa e fix in audit o incident log.
• Aggiungere un check automatico se il problema era prevedibile.
• Eseguire backup se sono stati modificati dati o configurazioni critiche.

Incident log

2026-06-24 - Sonja Trekking produzione senza DATABASE_URL

Sintomo:

• https://www.sonjatrekking.com/it/escursioni restituiva errore applicativo;
• log Vercel: Environment variable not found: DATABASE_URL;
• Prisma non riusciva a inizializzare il datasource configurato in prisma/schema.prisma.

Causa:

• in Vercel Production mancava DATABASE_URL;
• le escursioni non erano state cancellate: l'app non riusciva a collegarsi al database.

Fix eseguito:

• verificato che il container VPS sonja-trekking avesse DATABASE_URL configurato;
• aggiunta DATABASE_URL come env sensitive in Vercel Production;
• eseguito vercel redeploy dell'ultimo deployment Production, evitando di deployare modifiche locali non confermate.

Verifica:

curl -L -sS -o /tmp/sonja-check.html \
  -w 'http=%{http_code} final=%{url_effective} size=%{size_download}\n' \
  https://www.sonjatrekking.com/it/escursioni

Risultato atteso:

• HTTP 200;
• nessun marker Environment variable not found, Application error, Internal Server Error o PrismaClientInitializationError.