Fixes #577 - Added note for transaction-based pooling

zammad · Nov 25, 2024 · 818edcc · 818edcc
1 parent 272d83e
commit 818edcc
Showing 1 changed file with 7 additions and 0 deletions.
diff --git a/prerequisites/software.rst b/prerequisites/software.rst
@@ -162,6 +162,13 @@ You can choose between the following database servers:
 
    .. include:: /appendix/includes/mysql-deprication-note.rst
 
+.. note::
+   If you use database connection pooling software like PgBouncer, make sure
+   to use a pooling mode that is fully compatible with PostgreSQL. Typically
+   this is called "session connection pooling". Transaction-based connection
+   pooling is not supported and may lead to errors during database migrations.
+
+
 For **MySQL/MariaDB**, the following configuration is required:
 
 * Use ``UTF-8`` encoding - ``utf8mb4`` for example will fail!