From 5f50022bb464c01d06de9640c962eafaf4a986e3 Mon Sep 17 00:00:00 2001
From: notplants <@notplants>
Date: Mon, 22 Jun 2026 19:24:49 +0000
Subject: [PATCH] docs: drop healthcheck comment; rephrase release note
 POSTGRES_USER warning + check command

---
 compose.yml         |  3 ---
 release/1.0.0+3.5.3 | 15 +++++++--------
 2 files changed, 7 insertions(+), 11 deletions(-)

diff --git a/compose.yml b/compose.yml
index ab7b866..8ad31ee 100644
--- a/compose.yml
+++ b/compose.yml
@@ -107,9 +107,6 @@ services:
       interval: 30s
       timeout: 10s
       retries: 5
-      # generous: on a major-version bump the image installs the old binaries and
-      # runs pg_upgrade on first boot before the server accepts connections —
-      # don't let the healthcheck kill an in-progress migration
       start_period: 15m
     deploy:
       labels:
diff --git a/release/1.0.0+3.5.3 b/release/1.0.0+3.5.3
index bcb61cd..7562b6f 100644
--- a/release/1.0.0+3.5.3
+++ b/release/1.0.0+3.5.3
@@ -9,12 +9,11 @@ Rename these in your app's .env (the values carry over):
   DISCOURSE_SMTP_AUTH     --> DISCOURSE_SMTP_AUTHENTICATION
   DISCOURSE_SMTP_PROTOCOL --> DISCOURSE_SMTP_ENABLE_START_TLS (takes a boolean true/false, not the old tls/ssl value, so translate it rather than copying it straight across)
 
-The database now runs the discourse/postgres image, which upgrades your existing
-postgres cluster to a new major version in place on first boot (no dump/restore).
+WARNING: if your deployment's database has an "install user" other than `postgres`
+(some older deployments do), you must set the POSTGRES_USER env var in your .env
+for this migration, otherwise the postgres upgrade aborts with an install-user
+mismatch.
 
-That upgrade runs as the cluster's bootstrap superuser ("install user"), which the
-recipe sets via POSTGRES_USER, defaulting to `postgres`. This default is correct
-for clusters created by this recipe and the old bitnami recipe, so most operators
-need to do nothing. ONLY if your cluster was bootstrapped with a different
-superuser (e.g. `discourse`) must you set POSTGRES_USER in your app's .env before
-upgrading -- otherwise pg_upgrade aborts with an install-user mismatch.
+Check your old deployment's install user before upgrading:
+
+  abra app run YOURAPPDOMAIN db -- psql -U discourse -tAc 'select rolname from pg_roles where oid = 10'