Files
vps/runbooks
windyboy 079332e082 docs: record matrix_e2ee v0.3.0 deploy; fix and rename matrix-e2ee update runbook
- Deploy v0.3.0 (main 216cc99, W1N-180 bot-initiated device verification
  wizard) on hass.windy.lan; backup matrix_e2ee.bak-20260818-v0.2.10
- Fix runbook: tag-only prerequisite (v0.3.0 was untagged), working-tree
  HEAD check, rsync exit-23 note, actual setup log line, post-deploy record
  step, ssh_config.d -F /dev/null gotcha
- Rename runbook matrix-e2e-update.md -> matrix-e2ee-update.md and update
  AGENTS.md/hosts references (domain is matrix_e2ee, double-e)
- Unify matrix_e2ee naming and update version history in
  docs/home-assistant-matrix.md
2026-08-18 13:31:15 +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.