Maintenance Procedure¶
This runbook describes the standard maintenance workflow for the homelab.
Maintenance should be performed during low usage periods.
Maintenance Checklist¶
- Verify backups exist
- Announce maintenance (if other users exist)
- Stop non‑critical services
- Update infrastructure
- Restart services
- Verify all endpoints
- Monitor logs
Pre‑Maintenance Checks¶
Verify services are healthy:
Internal:
- homepage.home
- paperless.home
- rezepte.home
- ha.home
External:
- paperless.salassi.de
- rezepte.salassi.de
- ha.salassi.de
Check container status:
docker ps
Check LXC containers:
pct list
Stop Non‑Critical Services¶
Example:
docker compose down
Or individual container:
docker stop
Avoid stopping:
- AdGuard
- Unbound
- Cloudflare Tunnel
These maintain network connectivity.
Perform Updates¶
Follow service‑specific update procedures:
- Docker services → redeploy stack
- LXC containers → apt update / upgrade
- Proxmox host → apt dist-upgrade
Refer to:
operations/updates.md
Restart Services¶
Restart Docker stacks:
docker compose up -d
Restart services if needed:
systemctl restart
Verify containers:
docker ps
Post‑Maintenance Verification¶
Check internal services:
homepage.home paperless.home rezepte.home ha.home
Check external access:
paperless.salassi.de rezepte.salassi.de ha.salassi.de
Monitoring¶
Monitor logs for several minutes after maintenance.
Docker logs:
docker logs -f
System logs:
journalctl -xe
Notes¶
- Never perform infrastructure updates without backups
- Avoid updating multiple layers simultaneously