⚠️ Important: Docker Compose update for PostgreSQL / TimescaleDB

[x0sina]

If you are using PostgreSQL or TimescaleDB with PasarGuard, please update your docker-compose.yml to the officially maintained templates below.

✅ Recommended Docker Compose files

• TimescaleDB
  https://github.com/PasarGuard/scripts/blob/main/pasarguard-timescaledb.yml
• PostgreSQL
  https://github.com/PasarGuard/scripts/blob/main/pasarguard-postgresql.yml

These setups include PgBouncer for connection pooling and are tuned for high concurrency and stability.

---

🔧 Required ENV change (VERY IMPORTANT)

If you are using PgBouncer, you must connect the application to PgBouncer, not directly to PostgreSQL.

➡️ Change your SQLAlchemy database port from 5432 to 6432 in .env:

Use asyncpg via PgBouncer like this:

SQLALCHEMY_DATABASE_URL=postgresql+asyncpg://DB_USER:DB_PASSWORD@127.0.0.1:6432/DB_NAME

✅ connects to PgBouncer (6432)

• 5432 → PostgreSQL internal port
• 6432 → PgBouncer port ✅ (this is what PasarGuard must use)

Failing to do this may cause:

• Connection exhaustion
• Random disconnects
• Performance issues under load

---

✅ Notes

• No data loss if volumes remain unchanged
• depends_on + healthcheck ensure correct startup order
• Works with high traffic setups
• Recommended for production

If you have any questions or migration issues, feel free to comment below 👇

---

اگر از PostgreSQL یا TimescaleDB همراه با PasarGuard استفاده می‌کنید، لطفاً فایل docker-compose.yml خود را با قالب‌های رسمی زیر به‌روزرسانی کنید.

✅ فایل‌های پیشنهادی Docker Compose

• TimescaleDB
  https://github.com/PasarGuard/scripts/blob/main/pasarguard-timescaledb.yml

• PostgreSQL
  https://github.com/PasarGuard/scripts/blob/main/pasarguard-postgresql.yml

این تنظیمات شامل PgBouncer برای Connection Pooling هستند و برای ترافیک بالا و پایداری بیشتر بهینه شده‌اند.

---

🔧 تغییر ضروری در ENV (بسیار مهم)

اگر از PgBouncer استفاده می‌کنید، باید اپلیکیشن را به PgBouncer متصل کنید، نه مستقیماً به PostgreSQL.

➡️ پورت دیتابیس SQLAlchemy را در .env از 5432 به 6432 تغییر دهید:

از asyncpg از طریق PgBouncer به این صورت استفاده کنید:

SQLALCHEMY_DATABASE_URL=postgresql+asyncpg://DB_USER:DB_PASSWORD@127.0.0.1:6432/DB_NAME

این مقدار به PgBouncer (پورت 6432) متصل می‌شود. ✅

• 5432 → پورت داخلی PostgreSQL
• 6432 → پورت PgBouncer ✅ (این پورتی است که PasarGuard باید از آن استفاده کند)

اگر این تغییر را اعمال نکنید، ممکن است با مشکلات زیر مواجه شوید:

• کمبود Connection
• قطع اتصال‌های تصادفی
• افت عملکرد در زمان ترافیک بالا

---

✅ نکات

• در صورتی که Volumeها تغییر نکنند، هیچ داده‌ای از بین نخواهد رفت
• depends_on + healthcheck ترتیب صحیح بالا آمدن سرویس‌ها را تضمین می‌کند
• مناسب برای ترافیک بالا
• توصیه‌شده برای محیطProduction

اگر سوال یا مشکلی در فرآیند مهاجرت دارید، در ادامه پیام بگذارید 👇