Control Center

The Orkestra Control Center is a web UI for monitoring one or more Orkestra runtime instances. It derives all its data directly from the runtime APIs — no instrumentation, no custom metrics, no extra configuration.

Start it with one command:

ork control

Open http://localhost:8081.


What You Get

  • Control Center — the global view. All Katalogs from all configured runtimes on one page.
  • Control Panel — per-Katalog drill-down. CRD cards, worker pools, queue pressure, error rates.
  • CRD Detail — per-CRD deep dive. Every worker’s state, RBAC permissions, dependencies, admission metrics.

Starting

# Default: port 8081, points at localhost:8080
ork control

# Custom port
ork control --port 9090

# Multiple Orkestra runtimes
ork control --urls "http://cluster1:8080,http://cluster2:8080"

# Start with no preconfigured runtimes (add them from the UI)
ork control --ignore-default

Flags

FlagDefaultDescription
-p, --port8081Port to serve the Control Center on
-u, --urlshttp://localhost:8080Comma-separated Orkestra runtime URLs
--refresh10sHow often to fetch fresh data from runtimes
--log-levelinfoLog level: debug, info, warn, error
--ignore-defaultfalseStart with no preconfigured runtime URLs

Environment Variables

VariableDescriptionDefault
ADMIN_USERNAMELogin usernameadmin
ADMIN_PASSWORDLogin passwordadmin
SESSION_SECRETCookie signing secretdev-secret
ORK_CC_PORTOverride port8081
ORK_CC_REFRESHOverride refresh interval10s

Set ADMIN_USERNAME, ADMIN_PASSWORD, and SESSION_SECRET to non-default values in any non-local environment.


Architecture

Browser
   │
   ▼
Control Center (port 8081)
   │ aggregates from
   ├── Orkestra Runtime 1 (port 8080)
   ├── Orkestra Runtime 2 (port 8080)
   └── Orkestra Runtime N ...

Each runtime exposes /katalog, /katalog/{crd}, and /katalog/{crd}/health. The Control Center polls these and renders the results. It holds no state of its own.