From eac2e781f790ebd7f136fa942fe931185a6f1abb Mon Sep 17 00:00:00 2001
From: Bill <bill@bballou.com>
Date: Fri, 31 Oct 2025 12:42:41 -0400
Subject: [PATCH] docs: clarify API_PORT usage in .env.example

Added detailed comments explaining that container always uses port 8080
internally and API_PORT only controls host port mapping.
---
 .env.example | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/.env.example b/.env.example
index a457460..16dd7a1 100644
--- a/.env.example
+++ b/.env.example
@@ -25,7 +25,9 @@ TRADE_HTTP_PORT=8002
 GETPRICE_HTTP_PORT=8003
 
 # API Server Port (exposed on host machine for REST API)
-# Container always uses 8080 internally
+# Container ALWAYS uses port 8080 internally (hardcoded in entrypoint-api.sh)
+# This variable ONLY controls the host port mapping (host:8080 -> container:8080)
+# Change this if port 8080 is already in use on your host machine
 # Used for Windmill integration and external API access
 API_PORT=8080