67 lines
1.7 KiB
Markdown
67 lines
1.7 KiB
Markdown
# 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 |
|