From 4cc0d45344292e662037be08d39e40ea7d2d86f9 Mon Sep 17 00:00:00 2001
From: notplants <@notplants>
Date: Tue, 9 Jun 2026 15:26:24 +0000
Subject: [PATCH] docs: document automatic Postgres upgrades via pgautoupgrade

---
 README.md | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index b3f8f53..65bf9f2 100644
--- a/README.md
+++ b/README.md
@@ -24,6 +24,14 @@
 5. `abra app deploy YOURAPPDOMAIN`
 6. Open the configured domain in your browser to finish set-up
 
+## Postgres upgrades
+
+The `db` service uses the
+[`pgautoupgrade`](https://github.com/pgautoupgrade/pgautoupgrade) image, so when
+the recipe bumps the Postgres major version the existing cluster is upgraded in
+place automatically on the next `deploy` — no manual migration steps. As with
+any major database upgrade, **take a backup of the `<stack_name>_db` volume
+first** (e.g. `abra app backup <domain>`).
+
 [`abra`]: https://git.coopcloud.tech/coop-cloud/abra
 [`coop-cloud/traefik`]: https://git.coopcloud.tech/coop-cloud/traefik
-p-cloud/traefik