Merge pull request #10 from germondai/9-unable-to-use-any-other-port-numbers-other-than-8191

9 unable to use any other port numbers other than 8191

.env.example

@@ -3,7 +3,7 @@ BROWSER_POOL_SIZE=5
 SESSION_TTL_SECONDS=3600
 PROXY_URL=
 RESIDENTIAL_PROXY_URL=
-PORT_API=8191
+PORT=8191
 PORT_WEB=3000
 PORT_DOCS=3001
 

README.md

@@ -123,7 +123,7 @@ Synology note: many Synology NAS units (DSM 7.x on J4125 / older hardware) ship
 | `REDIS_URL`                  | `redis://localhost:6379` | Redis connection string                                                  |
 | `RESIDENTIAL_PROXY_URL`      | —                        | Enables Tier 4 proxy escalation                                          |
 | `STT_URL`                    | —                        | Local Whisper endpoint for reCAPTCHA (optional)                          |
-| `PORT_API`                   | `8191`                   | API listen port                                                          |
+| `PORT`                       | `8191`                   | API listen port                                                          |
 
 ## Stack
 

apps/api/src/index.ts

@@ -4,7 +4,7 @@ import type { FlareSolverrRequest, FlareSolverrResponse, PoolStats, ScrapeReques
 import { Elysia } from "elysia"
 
 const REDIS_URL = process.env.REDIS_URL ?? "redis://localhost:6379"
-const PORT = Number(process.env.PORT_API ?? "8191")
+const PORT = Number(process.env.PORT ?? "8191")
 const POOL_SIZE = Number(process.env.BROWSER_POOL_SIZE ?? "3")
 // How long acquire() will poll for a free browser before rejecting with PoolExhaustedError.
 // 15s covers a full CF challenge burst with pool=3 (queue depth 7, slowest finishes at ~12s).

apps/docs/api-reference/overview.md

@@ -11,7 +11,7 @@ description: Base URL, content types, and response conventions.
 http://localhost:8191
 ```
 
-Or wherever you've mapped `PORT_API` (default `8191`).
+Or wherever you've mapped `PORT` (default `8191`).
 
 ## Authentication
 

apps/docs/getting-started/configuration.md

@@ -130,11 +130,18 @@ Note: `proxy` on `/v1` is a TRAWL-specific extension — it is not part of the r
 
 ## Ports
 
-### `PORT_API`
+### `PORT`
 
 **Default:** `8191`
 
-Port the Elysia API server listens on. Defaults to `8191` — the same port FlareSolverr and Byparr use, so you can swap TRAWL in without changing any *arr app settings.
+Host port the Docker port mapping forwards to TRAWL's internal listener. Defaults to `8191` — the same port FlareSolverr and Byparr use, so you can swap TRAWL in without changing any *arr app settings. The container itself always listens on `8191` internally; `PORT` only changes the **host-side** port (e.g. `"${PORT:-8191}:8191"` in every compose file).
+
+To run TRAWL alongside FlareSolverr (or any other service that already binds `8191` on the host), set `PORT` in your shell or `.env` to any free port **before** running `docker compose up`:
+
+```bash
+PORT=9191 docker compose up -d
+# TRAWL reachable at http://localhost:9191, while port 8191 stays free for FlareSolverr.
+```
 
 ### `PORT_WEB`
 
@@ -162,6 +169,6 @@ PROXY_LIST_FILE=
 RESIDENTIAL_PROXY_LIST_FILE=
 
 # ── Ports ─────────────────────────────────────
-PORT_API=8191
+PORT=8191
 PORT_WEB=3000
 ```

docker-compose.full.yml

@@ -14,7 +14,7 @@ services:
     image: ghcr.io/germondai/trawl:latest
     restart: unless-stopped
     ports:
-      - "${PORT_API:-8191}:8191"
+      - "${PORT:-8191}:8191"
     environment:
       - REDIS_URL=redis://redis:6379
       - BROWSER_POOL_SIZE=${BROWSER_POOL_SIZE:-3}

docker-compose.minimal.yml

@@ -2,7 +2,7 @@ services:
   trawl:
     image: ghcr.io/germondai/trawl:latest
     ports:
-      - "8191:8191"
+      - "${PORT:-8191}:8191"
     shm_size: 1gb
     environment:
       BROWSER_POOL_SIZE: 1

docker-compose.prod.yml

@@ -9,7 +9,7 @@ services:
     image: ghcr.io/germondai/trawl:latest
     restart: always
     ports:
-      - "8191:8191"
+      - "${PORT:-8191}:8191"
     shm_size: 1gb
     mem_limit: 3g
     environment:

docker-compose.yml

@@ -7,11 +7,11 @@ services:
   trawl:
     image: ghcr.io/germondai/trawl:latest
     ports:
-      - "8191:8191"
+      - "${PORT:-8191}:8191"
     shm_size: 1gb
     environment:
       REDIS_URL: redis://redis:6379
-      BROWSER_POOL_SIZE: 3
+      BROWSER_POOL_SIZE: ${BROWSER_POOL_SIZE:-3}
     depends_on:
       - redis
     healthcheck: