Problem
The README's "Updating" section and MIGRATION.md cover the mechanics of bumping versions, but there is no single runbook that walks an operator through a safe upgrade end to end - in particular taking a backup first, verifying afterwards, and rolling back if it fails. This is the most common self-host question upstream:
- huly-selfhost#221 - How can I upgrade huly-selfhost?
- huly-selfhost#91 - How can I upgrade the Huly version?
- huly-selfhost#51 - Updating via Issue Board
Proposal
Add guides/upgrading.md: review MIGRATION.md -> backup -> stop -> pull -> set version -> pull images -> up -> verify -> rollback. Link it from the README's Updating section. Pairs with the Compose backup/restore work in #1.
A PR follows. Contributed by Exaviz (exaviz.com).
Problem
The README's "Updating" section and
MIGRATION.mdcover the mechanics of bumping versions, but there is no single runbook that walks an operator through a safe upgrade end to end - in particular taking a backup first, verifying afterwards, and rolling back if it fails. This is the most common self-host question upstream:Proposal
Add
guides/upgrading.md: review MIGRATION.md -> backup -> stop -> pull -> set version -> pull images -> up -> verify -> rollback. Link it from the README's Updating section. Pairs with the Compose backup/restore work in #1.A PR follows. Contributed by Exaviz (exaviz.com).