docs(ops): describe the move to a newer Postgres major

The compose file stays on 16. Changing only the image line stops the stack:
the 18 image refuses a data directory from an older major and expects its
volume one level up. The runbook walks the dump and restore into a fresh
volume, keeps the old one as the way back, and is linked from the update
section and the compose pin.
This commit is contained in:
Marc-André Bombeck committed 2026-10-25 03:06:37 +01:00
1 parent 84064ea045
commit ffd06ce289
3 files changed
+96 -1

No files matched your search

+4
View File
@@ -393,6 +393,10 @@ curl -s http://localhost:3000/api/version
Keep the dump until the new version has run for a few days, and keep your
encryption key with it: a dump without the key cannot be read.
The database image is a separate matter: a new Postgres minor is a change of
the `image:` line, a new major (16 to 18) is a dump and restore, described in
[`docs/ops/postgres-major-upgrade.md`](../ops/postgres-major-upgrade.md).
The start log says what is about to happen before the migrations run:
```text