From 368dd866113aa8dea5ad91ba54d9d4b64845987b Mon Sep 17 00:00:00 2001
From: ralf401 <rsc@zammad.com>
Date: Mon, 25 Nov 2024 10:15:13 +0100
Subject: [PATCH] Fixes #577 - Added note for transaction-based pooling

---
 prerequisites/software.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/prerequisites/software.rst b/prerequisites/software.rst
index 58f801a..854e8fd 100644
--- 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!