# 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 |