Quelle: ddx-documentation/ports.md
Every host port lives in the 96XX band, 9600-9699 (owner D6, invariant 3). This page is the one source. Docker network `osprey` (`10.196.96.0/24`), created by `./ddx-manage.sh` `ensure_network`. Compose files, `.env.example` files and `./ddx-manage.sh` use these values. | Service | Host port | Container port | Owner | Where the port is set | |---|---|---|---|---| | ddx-web (Next.js) | 9600 | — (host process) | `ddx-web/` | `--port 9600` in `ddx-web/package.json` (`dev`, `start`); `PORT` set by `./ddx-manage.sh` | | ddx-api (NestJS) | 9601 | — (host process) | `ddx-api/` | `PORT=9601` in `ddx-api/.env`; ddx-web server-only `DDX_BFF_POOL_STATIC_NODES=api-dev-001=http://127.0.0.1:9601` | | ddx-api second node `api2` (NestJS) | 9602 | — (host process) | `ddx-api/` | `./ddx-manage.sh start api2`; node id `api-dev-002`; listed in `DDX_BFF_POOL_STATIC_NODES` / `DDX_BFF_REGISTRY_SEEDS` (`ddx-web/CLAUDE.md` §Environment) | | PostgreSQL 18 | 9640 | 5432 | `ddx-docker-postgres/` | compose maps `127.0.0.1:9640:5432` (fixed, no env key); `DATABASE_URL_*` use host port 9640 | | Redis 7+ | 9641 | 6379 | `ddx-docker-redis/` | compose maps `127.0.0.1:9641:6379` (fixed); `REDIS_URL=redis://127.0.0.1:9641` (Centrifugo engine and ddx-api cache and registry; no in-memory fallback) | | MinIO S3 API | 9642 | 9000 | `ddx-docker-minio/` | compose maps `127.0.0.1:9642:9000` (fixed); `DDX_API_MINIO_ENDPOINT=http://127.0.0.1:9642` | | MinIO console | 9643 | 9001 | `ddx-docker-minio/` | compose maps `127.0.0.1:9643:9001` (fixed) | | Qdrant HTTP/REST | 9644 | 6333 | `ddx-docker-qdrant/` | compose maps `127.0.0.1:9644:6333` (fixed); `DDX_API_QDRANT_URLS=http://127.0.0.1:9644` | | Qdrant gRPC | 9645 | 6334 | `ddx-docker-qdrant/` | compose maps `127.0.0.1:9645:6334` (fixed) | | Docs | 9670 | — | reserved | RESERVED, unused (Q8: docs render inside ddx-web) | | Mail SMTP (GreenMail, dev) | 9646 | 3025 | `ddx-docker-mail/` | compose maps `127.0.0.1:9646:3025` (fixed); `DDX_API_SMTP_HOST`/`DDX_API_SMTP_PORT` in `ddx-api/.env` | | Mail IMAP (GreenMail, dev) | 9647 | 3143 | `ddx-docker-mail/` | compose maps `127.0.0.1:9647:3143` (fixed); `DDX_API_IMAP_HOST`/`DDX_API_IMAP_PORT` in `ddx-api/.env` | | Mail REST API (GreenMail) | 9648 | 8080 | `ddx-docker-mail/` | compose maps `127.0.0.1:9648:8080` (fixed) | | ddx-osprey-engine HTTP | 9630 | — (host process) | `ddx-osprey-engine/` | `ENGINE_PORT=9630` in `./ddx-manage.sh` and `OSPREY_HTTP_PORT=9630` in `ddx-osprey-engine/.env`; ddx-api reaches it through `DDX_API_OSPREY_ENGINE_URL` (loopback only). See [osprey-engine.md](/de/docs/osprey-engine) | | ddx-osprey-engine voice WebSocket | 9631 | — (host process) | `ddx-osprey-engine/src/voice/gateway.ts` | `OSPREY_VOICE_PORT`, default 9631; ddx-api dials 9631 (`ws://<engine host>:9631/voice`, ADR 0020). Bound on 127.0.0.1 by `src/server.ts` boot, loopback identity headers like the HTTP bridge (task 045) | | ddx-osprey-engine canary HTTP | 9632 | — (host process) | `deploy/` | deploy/ only, never run here; production canary engine on a target, 127.0.0.1 only, never in a vhost | | ddx-osprey-engine canary voice WebSocket | 9633 | — (host process) | `deploy/` | deploy/ only, never run here; canary engine sets `OSPREY_VOICE_PORT=9633`, 127.0.0.1 only, never in a vhost | | Centrifugo client | 9650 | 9650 | `ddx-docker-centrifugo/` | compose maps `127.0.0.1:9650:9650`; browser SDK: SSE first (`/connection/sse` + `/emulation`), WS fallback; set in `ddx-docker-centrifugo/config.json`, browser key `NEXT_PUBLIC_REALTIME_URL`; the prod compose project `osprey-prod` on a target uses the same host port (container `osprey-prod-centrifugo`) | | Centrifugo internal | 9651 | 9651 | `ddx-docker-centrifugo/` | server API, admin, health, metrics; server side only: ddx-api `DDX_API_CENTRIFUGO_API_URL`, engine `CENTRIFUGO_API_URL` (outbox relay); the prod compose project `osprey-prod` on a target uses the same host port (container `osprey-prod-centrifugo`). See [realtime.md](/de/docs/realtime) | | LiteLLM model router | 9655 | 4000 | `ddx-docker-litellm/` | compose maps `127.0.0.1:9655:4000`; engine `DUDOXX_BASE_URL=http://127.0.0.1:9655/v1`; loopback only; `router_settings.disable_cooldowns: true`; the prod compose project `osprey-prod` on a target uses the same host port (container `osprey-prod-litellm`) | | Closed "dead" port | 9649 | — | specs | never bind: spec fixtures dial it to prove fail-loud paths | | Redis Sentinel (reserved) | 9661-9663 | — | — | commented example in `ddx-api/.env.example`; no Redis HA in scope | | Deploy smoke self-test | 9697 | — | `deploy/scripts/smoke.sh` | transient, deploy rail only | Held by `ddx-mastra` on this host, never reassign: 9535 (Studio, the one allowed port outside the band) and 9610 (MCP auth suite listener, transient). ## Production ports (target `forge`) Same band, same numbers as local. Data-tier ports bind to `127.0.0.1` on the target only. Runbook: [deploy/README.md](/de/docs/deploy/README); target keys: `context/DEPLOY_TARGETS.md`. | Service | Host port | Notes | |---|---|---| | ddx-web live | 9600 | Apache :80 vhost on the target proxies to it; the home edge terminates TLS on :443 | | ddx-api live | 9601 | node `api-prod-001`; server-only address | | ddx-web canary | 9620 | smoke check before the switch; node `web-prod-901` | | ddx-api canary | 9603 | smoke check before the switch; node `api-prod-901` | | PostgreSQL | 9640 | `127.0.0.1` only | | Redis | 9641 | `127.0.0.1` only | | MinIO API / console | 9642 / 9643 | `127.0.0.1` only | | Qdrant HTTP | 9644 | `127.0.0.1` only | The canary nodes leave the cluster registry after a deploy (`quarantined`, `lost`). ## Rules - The container port column is the only place 5432, 6379, 9000 and 9001 may appear. A compose file maps `9640:5432`, `9641:6379`, `9642:9000`, `9643:9001` — never the default on the host side (failure mode 5, AC1.4). - Redis 9641 was free on dudoxxmac on 2026-10-23 (`lsof -nP -iTCP:9641 -sTCP:LISTEN` → no listener, exit 1; sse-bus task 001). - The ddx-api addresses are server-only (`DDX_BFF_POOL_STATIC_NODES` in static mode, `DDX_BFF_REGISTRY_SEEDS` in registry mode). The browser never gets a ddx-api address: no `NEXT_PUBLIC_API_URL`, no `localhost:9601` in `ddx-web/src` (invariant 1, AC3.2/AC3.3). The browser calls ddx-web `api/v1`, and the BFF calls ddx-api through `BffApiBridge`. The single-URL key was removed on 2026-10-24; static mode without `DDX_BFF_POOL_STATIC_NODES` is a boot error `BFF_POOL_STATIC_NODES_REQUIRED`. - The dudoxx-sandbox-creator default band (3400-3490) is overridden per service (Q9, [ADR 0001](/de/docs/adr/0001-scaffold-route)). No service keeps a creator default. - The sibling HMS stack ports are not reused. The 96XX band is reserved for this workspace (owner order 2026-10-28, `plans/osprey-engine/discuss.md` D6); 9650/9651 were the first claim. - Resolve a live port with `lsof -nP -iTCP:<port> -sTCP:LISTEN` before you start a service. `./ddx-manage.sh` owns start and stop. --- Last reconciled: 2026-10-29 · plan ai-assistant-platform task 053
Every host port lives in the 96XX band, 9600-9699 (owner D6, invariant 3). This page is the one source.
Docker network osprey (10.196.96.0/24), created by ./ddx-manage.sh ensure_network.
Compose files, .env.example files and ./ddx-manage.sh use these values.
Held by ddx-mastra on this host, never reassign: 9535 (Studio, the one allowed port outside
the band) and 9610 (MCP auth suite listener, transient).
forge)Same band, same numbers as local. Data-tier ports bind to 127.0.0.1 on the target only.
Runbook: ; target keys: context/DEPLOY_TARGETS.md.
The canary nodes leave the cluster registry after a deploy (quarantined, lost).
9640:5432, 9641:6379, 9642:9000, 9643:9001 — never the
default on the host side (failure mode 5, AC1.4).lsof -nP -iTCP:9641 -sTCP:LISTEN →
no listener, exit 1; sse-bus task 001).DDX_BFF_POOL_STATIC_NODES in static mode,
DDX_BFF_REGISTRY_SEEDS in registry mode). The browser never gets a ddx-api address: no
NEXT_PUBLIC_API_URL, no localhost:9601 in ddx-web/src (invariant 1, AC3.2/AC3.3).
The browser calls ddx-web api/v1, and the BFF calls ddx-api through BffApiBridge.
The single-URL key was removed on 2026-10-24; static mode without
DDX_BFF_POOL_STATIC_NODES is a boot error BFF_POOL_STATIC_NODES_REQUIRED.plans/osprey-engine/discuss.md D6); 9650/9651 were the first claim.lsof -nP -iTCP:<port> -sTCP:LISTEN before you start a
service. ./ddx-manage.sh owns start and stop.Last reconciled: 2026-10-29 · plan ai-assistant-platform task 053
adr/
deploy/
research/