Compose Service Catalog
The four deployments use a common service architecture. A service may be omitted, duplicated under another runtime identity, or placed behind a Compose profile, but its configuration boundary remains the same.
| Service or group | Responsibility | Default host port when published |
|---|---|---|
| PostgreSQL and bootstrap jobs | Portal, Knowledge and operational persistence; schema and credential preparation | 5432 |
| Light OAuth | OAuth/OIDC tokens, authorization and JWKS | 6881 |
| Controller | Runtime registration, control transport and execution coordination | Internal in current stacks |
| Config Server | Host/service/environment-specific configuration snapshots | 8435 |
| Hybrid command and query | Java Portal command/query APIs and projections | 8439, 8440 |
| Portal service | Rust Portal APIs and integration endpoints | 2498 |
| Light Gateway | Public Portal BFF, API routing, MCP and static UI | 443 |
| LLM Gateway | Dedicated OpenAI-compatible model routing profile | 8444 |
| Light Workflow | Workflow execution and workflow-backed MCP tools | 8436 |
| Light Agent | Agent runtime and optional specialized service instances | 8083 and service-specific ports |
| Light Knowledge | Knowledge API, administration and asynchronous worker | 8092 for the public API |
| Light A2A | Optional Agent-to-Agent transport | Profile-dependent |
| Demo services | Regression and tutorial REST/MCP backends | 8085–8087 |
| Enterprise Portal BFF | Optional Microsoft Entra SSO BFF in bootstrap deployment | 8445 |
Image tags and exact environment assignments are deployment inputs and may change independently. Use this catalog for meaning and constraints, then check the selected distribution’s current Compose file for its concrete value.