From 415d115b17ac4590ab18ec39f847272bddf75184 Mon Sep 17 00:00:00 2001
From: pewdiepie-archdaemon <pewdiepie-archdaemon@users.noreply.github.com>
Date: Mon, 1 Jun 2026 11:20:25 +0900
Subject: [PATCH] Make Docker web port configurable

---
 .env.example       | 4 ++++
 README.md          | 2 ++
 docker-compose.yml | 2 +-
 3 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/.env.example b/.env.example
index 44a6e15..dfbbe6d 100644
--- a/.env.example
+++ b/.env.example
@@ -49,6 +49,10 @@ SEARXNG_INSTANCE=http://localhost:8080
 # Enable authentication (default: true)
 # AUTH_ENABLED=true
 
+# Host port for the Odysseus web UI in Docker Compose.
+# Change this if another local service already uses 7000 (macOS AirPlay often does).
+# APP_PORT=7000
+
 # Development-only auth bypass for loopback requests.
 # Keep false for Docker, LAN, reverse proxy, and any shared deployment.
 # LOCALHOST_BYPASS=false
diff --git a/README.md b/README.md
index ec62147..6f674f8 100644
--- a/README.md
+++ b/README.md
@@ -56,6 +56,8 @@ docker compose up -d --build
 ```
 Compose starts Odysseus, ChromaDB, SearXNG, and ntfy. First run does a full
 image build. Open `http://localhost:7000` after the containers are healthy.
+If port `7000` is already taken, set `APP_PORT=7001` (or another free port)
+in `.env`, recreate the container, and open `http://localhost:7001`.
 
 Cookbook remote servers use an Odysseus-owned SSH key from `./data/ssh`
 inside Docker. In **Cookbook -> Settings -> Servers**, generate/copy the
diff --git a/docker-compose.yml b/docker-compose.yml
index 2d8e308..afc3dfd 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -2,7 +2,7 @@ services:
   odysseus:
     build: .
     ports:
-      - "7000:7000"
+      - "${APP_PORT:-7000}:7000"
     volumes:
       - ./data:/app/data
       - ./logs:/app/logs