Files
vps/runbooks
windyboy e5819eeba3 docs: correct hass hardware to x88 Pro physical box; sync CSG v1.3.2
- hass.windy.lan is a physical x88 Pro box (HAOS bare-metal, machine: green,
  CPE x88pro20, virtualization empty) — not PVE VM 180 (verified live 2026-08-18)
- Record CSG v1.3.2 (934f58c, W1N-118) deploy in maintenance runbook verify
  section and hosts live-tree section (backups now include w1n118)
2026-08-18 13:32:33 +08:00
..

Runbook index

Entry point for all runbooks. Before operational work, read the repo entry AGENTS.md and the spec RUNBOOKS.md. New runbooks start from _template.md.

Route by intent

Intent Runbook Type
mailcow health check mailcow-health.md read-only
mailcow update mailcow-update.md change (gated)
mailcow SMTP/IMAP client mailcow-smtp-client.md reference
Vaultwarden health check vaultwarden-health.md read-only
Vaultwarden SQLite→PG migrate vaultwarden-sqlite-to-postgres.md change (destructive)
PowerDNS health check pdns-health.md read-only
RustDesk health check rustdesk-health.md read-only
Matrix health check matrix-health.md read-only
AdGuard Home health check adguard-home-health.md read-only
Home Assistant maintenance home-assistant-maintenance.md change (gated)
Routine Ansible operations ansible-operations.md change (allowlisted)
Linear issue → mergeable change issue-to-merge.md delivery
Failing health/playbook run fix-ci.md change
Release a reviewed change to production release.md change (gated)
Roll back a change rollback.md change (gated)
Controlled network configuration network-change.md change (gated)
Network outage / service recovery network-recovery.md recovery

Notes

  • fix-ci.md, release.md, rollback.md, network-change.md, network-recovery.md are adapted from the upstream guide to this repo's VPS-ops context (execution layer is Ansible + SSH + Linear, not a software CI/CD pipeline).
  • Health runbooks are read-only; they stop (STOP) when live state conflicts with the expected state instead of mutating production.