From c98432ca7d583267c8e862245b339a0d375cda90 Mon Sep 17 00:00:00 2001
From: VPN SaaS Dev <dev@vpnsaas.local>
Date: Sat, 16 May 2026 21:30:19 +0900
Subject: [PATCH] docker-deploy-port-config

---
 DEPLOY.md          | 7 +++++++
 docker-compose.yml | 2 +-
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/DEPLOY.md b/DEPLOY.md
index 49d4998..041eeec 100644
--- a/DEPLOY.md
+++ b/DEPLOY.md
@@ -33,6 +33,13 @@ python -m scripts.bootstrap_admin
 curl -fsS http://127.0.0.1:8000/ready
 ```
 
+If port `8000` is already used on the host, set `APP_PORT` in `.env` and point the reverse proxy to that local port:
+
+```bash
+APP_PORT=8010
+curl -fsS http://127.0.0.1:8010/ready
+```
+
 The default compose stack includes Postgres, Redis, API and bot services with health checks, restart policies and log rotation.
 Telegram notifications are the primary pilot notification channel. Browser push currently stores subscriptions and is treated as beta until server-side Web Push delivery is enabled.
 
diff --git a/docker-compose.yml b/docker-compose.yml
index c302093..fb3ec52 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -59,7 +59,7 @@ services:
       VAPID_PUBLIC_KEY: ${VAPID_PUBLIC_KEY:-}
       VAPID_PRIVATE_KEY: ${VAPID_PRIVATE_KEY:-}
     ports:
-      - "127.0.0.1:8000:8000"
+      - "127.0.0.1:${APP_PORT:-8000}:8000"
     healthcheck:
       test: ["CMD-SHELL", "python -c \"import urllib.request; urllib.request.urlopen('http://127.0.0.1:8000/ready', timeout=3).read()\""]
       interval: 10s