Sanitized mirror from private repository - 2026-04-20 01:24:42 UTC

docs/infrastructure/hosts/runbooks.md

@@ -0,0 +1,66 @@
+# Host Runbooks
+
+This directory contains operational runbooks for each host in the homelab infrastructure.
+
+## Available Runbooks
+
+- [Atlantis Runbook](./atlantis-runbook.md) - Synology DS1821+ (Primary NAS)
+- [Calypso Runbook](./calypso-runbook.md) - Synology DS723+ (Secondary NAS)
+- [Concord NUC Runbook](./concord-nuc-runbook.md) - Intel NUC (Home Automation & DNS)
+- [Homelab VM Runbook](./homelab-vm-runbook.md) - Proxmox VM (Monitoring & DevOps)
+- [RPi5 Runbook](./rpi5-runbook.md) - Raspberry Pi 5 (Edge Services)
+
+---
+
+## Common Tasks
+
+All hosts share common operational procedures:
+
+### Viewing Logs
+```bash
+# Via SSH to host
+docker logs <container_name>
+
+# Via Portainer
+Portainer → Containers → <container> → Logs
+```
+
+### Restarting Services
+```bash
+# Via docker-compose
+cd hosts/<host>/<service>
+docker-compose restart <service>
+
+# Via Portainer
+Portainer → Stacks → <stack> → Restart
+```
+
+### Checking Resource Usage
+```bash
+# Via Portainer
+Portainer → Containers → Sort by CPU/Memory
+
+# Via CLI
+docker stats
+```
+
+---
+
+## Emergency Contacts
+
+| Role | Contact | When to Contact |
+|------|---------|------------------|
+| Primary Admin | User | All critical issues |
+| Emergency | NTFY | Critical alerts only |
+
+---
+
+## Quick Reference
+
+| Host | Primary Role | Critical Services | SSH Access |
+|------|--------------|-------------------|------------|
+| Atlantis | Media, Vault | Vaultwarden, Plex, Immich | atlantis.local |
+| Calypso | Infrastructure | NPM, Authentik, Prometheus | calypso.local |
+| Concord NUC | DNS, HA | AdGuard, Home Assistant | concord-nuc.local |
+| Homelab VM | Monitoring | Prometheus, Grafana | 192.168.0.210 |
+| RPi5 | Edge | Immich (backup) | rpi5-vish.local |