++

README.md

@@ -300,13 +300,21 @@ Works with any OpenAI-compatible API: OpenAI, Anthropic (via proxy), Ollama, vLL
 
 ## Deployment
 
-### Docker Compose (recommended)
-
-```bash
-cp .env.example .env
-# Edit .env with your API key
-docker compose up --build
-```
+### Docker Compose (recommended)
+
+```bash
+cp .env.example .env
+# Edit .env with your API key
+mkdir -p data logs backend/logs custom_simulation
+docker compose up -d --build
+```
+
+The service listens on port `8000` by default (override the host port with
+`APP_PORT=8080`). SQLite data, human-readable simulation logs, structured
+logs, and custom scenario files are bind-mounted from the project directory.
+Check the deployment with `docker compose ps` and
+`curl http://127.0.0.1:8000/health`; follow logs with
+`docker compose logs -f app`.
 
 ### Render