Ports and URLs¶

User-facing URLs¶

Surface	URL
Manage UI	`http://localhost:${BF_MANAGE_WEB_PORT:-3000}`
Support Microsite	`http://localhost:${BF_SUPPORT_MICROSITE_PORT:-3001}`
Plan UI	`http://localhost:${BF_PLAN_UI_PORT:-3000}`
RabbitMQ UI	`http://localhost:${EX_RABBITMQ_UI_PORT:-15672}`

Core API Ports¶

Service	Host Port Default
`bf-manage-core`	`5001` (from `.env.tmpl`; Compose fallback is `5000` if unset)
`bf-manage-connect`	`5005`
`bf-manage-sitepwrmon`	`5010`
`bf-telematics`	`5015`
`bf-manage-incidents`	`5020`
`bf-digital-twin`	`5030`
`bf-route-modelling`	`5050`
`bf-schedule-creator`	`5200`
`bf-depot-sim`	`5123`

Important Port Notes¶

Manage and Plan are mode-exclusive in ./up; they share key host ports (3000, 5005, 5015, 5200), so do not run both stacks together in one Compose invocation.
Roaming currently reads BF_ROAMING_PORT in compose.yaml, while .env.tmpl defines BF_MANAGE_ROAMING_PORT; set BF_ROAMING_PORT in .env if you need to override roaming host port.

Port Layering Model¶

flowchart LR
  Browser[Browser] --> HostPorts[localhost mapped ports]
  HostPorts --> Containers[compose services]
  Containers --> InternalDNS[service-name DNS]
  InternalDNS --> DownstreamCalls[service-to-service HTTP]