Documentation

Operate from the dashboard.

The Cordum dashboard is an optional UI for approvals, run timelines, pack lifecycle, and policy operations. It provides a real-time view of your autonomous workflows.

Key Capabilities

Approvals inbox with approve/reject actions
Run timelines with steps, errors, and decisions
Jobs list plus global search
Pack install, verify, and uninstall
Policy bundles, snapshots, and audit history

Access & Endpoint

In a default Docker Compose setup, the dashboard is exposed locally. It connects to the API gateway using a pre-configured key.

Access

http://localhost:8082
/config.json

Dashboard Configuration

config.json structure

The dashboard reads its environment from a static JSON file at runtime.

config.json

{
  "apiBaseUrl": "http://localhost:8081",
  "apiKey": "super-secret-key",
  "tenantId": "default",
  "principalId": "dashboard",
  "principalRole": "secops"
}

Environment Variables

CORDUM_API_BASE_URL

Endpoint for API Gateway

CORDUM_API_KEY

Security key for authentication

CORDUM_TENANT_ID

Target tenant isolation

CORDUM_PRINCIPAL_ROLE

Set to 'secops' for write access

CORS Note: If hosting on a separate domain, ensure the dashboard origin is added to CORDUM_ALLOWED_ORIGINS on the gateway.

Policy Studio Access

Policy bundles are read-only unless principalRole is set to secops. This role allows you to simulate changes, publish new bundles, and manage rollback snapshots.

Troubleshooting

Blank data: verify apiBaseUrl and apiKey connectivity

401 errors: confirm API key matches the gateway config

No live updates: check /api/v1/stream reachable