From 75bbeed3002a4a4b4e76f20be25d96f810832034 Mon Sep 17 00:00:00 2001
From: Gilles Devillers <gildev@gmail.com>
Date: Sun, 25 Jan 2026 16:02:57 +0100
Subject: [PATCH] fix: use port configured in .env (#773)

---
 .devcontainer/docker-compose.yml | 2 +-
 .env.local.example               | 4 ++++
 .env.test.example                | 4 ++++
 compose.example.ai.yml           | 2 +-
 compose.example.yml              | 2 +-
 5 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/.devcontainer/docker-compose.yml b/.devcontainer/docker-compose.yml
index cfaf22ece..3a48dc7a8 100644
--- a/.devcontainer/docker-compose.yml
+++ b/.devcontainer/docker-compose.yml
@@ -21,7 +21,7 @@ services:
       - ..:/workspace:cached
       - bundle_cache:/bundle
     ports:
-      - "3000:3000"
+      - ${PORT:-3000}:3000
     command: sleep infinity
     environment:
       <<: *rails_env
diff --git a/.env.local.example b/.env.local.example
index 9bcaf3da4..e91e7cf0e 100644
--- a/.env.local.example
+++ b/.env.local.example
@@ -1,6 +1,10 @@
 # To enable / disable self-hosting features.
 SELF_HOSTED = true
 
+# Custom port config
+# For users who have other applications listening at 3000, this allows them to set a value puma will listen to.
+PORT=3000
+
 # SimpleFIN runtime flags (default-off)
 # Accepted truthy values: 1, true, yes, on
 # SIMPLEFIN_DEBUG_RAW: when truthy, logs the raw payload returned by SimpleFIN (debug-only; can be noisy)
diff --git a/.env.test.example b/.env.test.example
index 14a75ea3e..9b0fbb62b 100644
--- a/.env.test.example
+++ b/.env.test.example
@@ -1,5 +1,9 @@
 SELF_HOSTED=false
 
+# Custom port config
+# For users who have other applications listening at 3000, this allows them to set a value puma will listen to.
+PORT=3000
+
 # SimpleFIN runtime flags (default-off)
 # Accepted truthy values: 1, true, yes, on
 # SIMPLEFIN_DEBUG_RAW: when truthy, logs the raw payload returned by SimpleFIN (debug-only; can be noisy)
diff --git a/compose.example.ai.yml b/compose.example.ai.yml
index 0230b8166..6a2e9f78d 100644
--- a/compose.example.ai.yml
+++ b/compose.example.ai.yml
@@ -106,7 +106,7 @@ services:
     volumes:
       - app-storage:/rails/storage
     ports:
-      - "3000:3000"
+      - ${PORT:-3000}:3000
     restart: unless-stopped
     environment:
       <<: *rails_env
diff --git a/compose.example.yml b/compose.example.yml
index f8c33e9ad..a01daca2e 100644
--- a/compose.example.yml
+++ b/compose.example.yml
@@ -50,7 +50,7 @@ services:
     volumes:
       - app-storage:/rails/storage
     ports:
-      - 3000:3000
+      - ${PORT:-3000}:3000
     restart: unless-stopped
     environment:
       <<: *rails_env