From 2d2fdef889f07b439a11437467fdb8af79ead341 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Korbinian=20P=C3=B6ppel?=
 <37810656+kpoeppel@users.noreply.github.com>
Date: Wed, 1 Feb 2023 09:31:04 +0100
Subject: [PATCH] Update FAQs for docker port problems. (#1045)

---
 docs/docs/faq/faq.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/docs/docs/faq/faq.md b/docs/docs/faq/faq.md
index 025ae02b..4b1d16eb 100644
--- a/docs/docs/faq/faq.md
+++ b/docs/docs/faq/faq.md
@@ -90,3 +90,17 @@ getting permission denied (using root user), you can try the following:
     # And remove the container
     docker rm -f <container id>
 ```
+
+### Docker Port Problems
+
+Oftentimes people already have some Postgres instance running on the dev
+machine. To avoid port problems, change the ports in the `docker-compose.yml` to
+ones excluding `5433`, like:
+
+1. Change `db.ports` to `- 5431:5431`.
+2. Add `POSTGRES_PORT: 5431` to `db.environment`
+3. Change `webdb.ports` to `- 5432:5431`
+4. Add `POSTGRES_PORT: 5431` to `db.environment`
+5. Add `- POSTGRES_PORT=5432` to `backend.environment`
+6. Change `web.environment.DATABASE_URL` to
+   `postgres://postgres:postgres@webdb:5432/oasst_web`