From 20d4585edb6e405b1360dadd69f6d3091b4b074e Mon Sep 17 00:00:00 2001
From: Ovidiu Eftimie <eovidiu@gmail.com>
Date: Fri, 20 Feb 2026 22:16:13 +0200
Subject: [PATCH] =?UTF-8?q?fix:=20docker=20run=20port=20mapping=20?=
 =?UTF-8?q?=E2=80=94=20map=20nginx=20port=2080,=20not=20internal=209010?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The Dockerfile binds CXDB_HTTP_BIND to 127.0.0.1:9010 (internal only)
and serves the UI and API via nginx on port 80. The docker run examples
mapped host 9010 to container 9010, which hit the internal-only Rust
HTTP server and returned empty responses.

Docker-compose files are unaffected since they override CXDB_HTTP_BIND
to 0.0.0.0:9010.
---
 README.md               | 4 ++--
 docs/deployment.md      | 2 +-
 docs/getting-started.md | 4 ++--
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 8ebf9fa..507b01f 100644
--- a/README.md
+++ b/README.md
@@ -16,7 +16,7 @@ The fastest way to try CXDB is with the pre-built Docker image:
 
 ```bash
 # Run the server (binary protocol :9009, HTTP :9010)
-docker run -p 9009:9009 -p 9010:9010 -v $(pwd)/data:/data cxdb/cxdb:latest
+docker run -p 9009:9009 -p 9010:80 -v $(pwd)/data:/data cxdb/cxdb:latest
 
 # Create a context and append a turn (HTTP write path)
 curl -X POST http://localhost:9010/v1/contexts/create \
@@ -74,7 +74,7 @@ pnpm build
 docker build -t cxdb:latest .
 
 # Run with persistent storage
-docker run -p 9009:9009 -p 9010:9010 \
+docker run -p 9009:9009 -p 9010:80 \
   -v $(pwd)/data:/data \
   -e CXDB_DATA_DIR=/data \
   cxdb:latest
diff --git a/docs/deployment.md b/docs/deployment.md
index de6b8f3..dea8c54 100644
--- a/docs/deployment.md
+++ b/docs/deployment.md
@@ -11,7 +11,7 @@ docker run -d \
   --name cxdb \
   --restart unless-stopped \
   -p 9009:9009 \
-  -p 9010:9010 \
+  -p 9010:80 \
   -v /var/lib/cxdb:/data \
   -e CXDB_DATA_DIR=/data \
   -e CXDB_LOG_LEVEL=info \
diff --git a/docs/getting-started.md b/docs/getting-started.md
index 5fe3be9..840964d 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -38,14 +38,14 @@ Run the server:
 docker run -d \
   --name cxdb \
   -p 9009:9009 \
-  -p 9010:9010 \
+  -p 9010:80 \
   -v $(pwd)/data:/data \
   cxdb:latest
 ```
 
 This starts:
 - Binary protocol server on `:9009`
-- HTTP gateway on `:9010`
+- UI and HTTP API on `:9010` (via nginx proxy)
 - Data persisted to `./data`
 
 ### Option B: From Source