Skip to main content

Runbooks

Operational procedures for SKIC Playground services.

note

Runbooks are living documents. Update them when procedures change or new issues are discovered.

Incident Severityโ€‹

LevelDefinitionResponse Time
P0Platform down / all services unreachableImmediate
P1Single critical service down< 15 min
P2Degraded performance / non-critical service down< 1 hour
P3Minor issue / cosmeticNext working session

Common Proceduresโ€‹

Restart a containerโ€‹

# SSH to TrueNAS
ssh root@lego-cloud.eu

# List running containers
docker ps

# Restart
docker restart <container-name>

# Check logs
docker logs -f --tail 100 <container-name>

Check Gitea Actions runner statusโ€‹

# On the runner host
systemctl status gitea-runner

# Restart if needed
systemctl restart gitea-runner

Force re-deploy from latest imageโ€‹

docker pull <registry>/<image>:<tag>
docker stop <container>
docker rm <container>
docker run -d --name <container> ... <image>:<tag>

Application-specific runbooksโ€‹

Individual application runbooks will be added here as applications go into production.