---
status: active
owner: platform
last_reviewed: 2026-09-29
supersedes: []
---
# Port scheme — oracle-vm2 (Venture Studio)
<!-- wiki:featured -->

**Phase 3:** prod **UI** `3Hxx` structured · dev UI `4Hxx` · prod API `8xxx` · dev API `9Hxx`.

## Decode a port

| Digit | Meaning |
|-------|---------|
| **1st (thousands)** | `3` = prod UI · `4` = dev UI · `8` = prod API · `9` = dev API |
| **2nd (hundreds)** | `0` = platform · `1` = SaaS products · `2` = utilities |
| **3rd–4th** | Product slot (same last two digits across prod/dev where possible) |

**Example:** `4107` → dev UI (`4`) · product (`1`) · slot (`07`); prod UI **`3107`**.

## Prod UI (`3Hxx`)

| App | Prod UI | Dev UI |
|-----|---------|--------|
| Venture Studio | **3003** | **4003** |
| Venture Console | **3013** | — |
| Astra | **3101** | **4101** |
| CareerOS | **3102** | **4102** |
| Legal Copilot | **3104** | **4104** |
| Deal Finder | **3105** | **4105** |
| compact-density | **3107** | **4107** |
| Blueprint | **3209** | **4209** |
| Athena | **3217** | **4217** |

Canonical env: `scripts/prod-ui-ports.sh`

## Public URL paths

| Surface        | Port | Public URL |
|----------------|------|------------|
| dashboard      | 3003 | / |
| studio-console | 3013 | /console/ |
| nous           | 3017 | /utilities/nous/ |
| blueprint      | 3209 | /utilities/blueprint/ |
| athena         | 3217 | /utilities/athena/ |
| astra          | 3101 | /astra/ |
| careeros       | 3102 | /careeros/ |
| legal-copilot  | 3104 | /legal/ |
| deal-finder    | 3105 | /deals/ |
| retired          | 3107 |  |

## Dev API (`9Hxx`)

| App | Prod API | Dev API | Dev API start |
|-----|----------|---------|---------------|
| Studio / Blueprint | 8000 | **9003** | `run-studio-dev-api.sh` |
| Astra / Legal | 8001 | **9101** | `run-astra-dev-api.sh` |
| CareerOS | 8002 | **9102** | `careeros-dev` docker |
| Deal Finder | 8005 | **9105** | `run-product-dev.sh deal-finder` |
| compact-density | 8007 | **9107** | `run-product-dev.sh retired` |
| Athena | 8017 | **9217** | `run-product-dev.sh athena` |

Override dev API ports via env. Fallback to prod API: `STUDIO_DEV_FALLBACK_PROD_API=1`.

## Infra (fixed)

| Service | Port |
|---------|------|
| Langfuse UI | 3000 |
| Langfuse MinIO | 9000 (host) — **do not use for dev API** |
| LiteLLM | 4000 |
| IB Gateway (paper) | 4002 |
| studio-postgres | 5432 |
| astra-postgres (prod) | 5433 |
| studio-dev-postgres-astra | 5434 |
| Redis | 6379 (dev overlay: db `1`) |
| Qdrant | 6333 |
| Ollama | 11434 |

## Status check

```bash
bash ~/studio-dev/scripts/status-dev-lane.sh    # dev lane
bash ~/studio/scripts/status-venture-stack.sh   # prod stack
```

## VM cutover (Phase 3 prod UI)

After merge to `main`:

```bash
cd ~/studio && git pull origin main
bash scripts/cutover-phase3-prod-ui-ports-vm.sh
```

## Roadmap

- **Phase 1** ✓ dev UI `4Hxx`
- **Phase 2** ✓ dev API `9Hxx`
- **Phase 2b** ✓ dev Astra API `:9101`
- **Phase 3** ✓ prod UI `3Hxx` structured renumber