Chronoverse documentation

Product, engineering, API, deployment, and operations documentation.

Chronoverse is a self-hosted distributed scheduler and orchestrator for running heartbeat checks and containerized workloads on your own infrastructure.

It combines a public HTTP API and dashboard with gRPC domain services, Kafka-driven workers, durable PostgreSQL state, live and retained logs, notifications, analytics, and OpenTelemetry observability.

What you can run

  • HEARTBEAT workflows for lightweight health checks without execution logs.
  • CONTAINER workflows for arbitrary Docker-backed commands with optional retained stdout and stderr.
  • Automatic interval-based jobs and immediate manual runs.

What the platform provides

State changes and matching events survive retries and restarts.
Only one execution worker owns a running job lease.
Stream output over SSE, retain it in ClickHouse, and search it through Meilisearch.
Traces, metrics, and structured logs flow into the bundled LGTM stack.

System shape

HTTP gatewaySessions · CSRF · REST · SSE
gRPC domains
usersworkflowsjobsnotificationsanalytics
Kafka workers
schedulerworkflowexecutionjob logsanalyticsoutbox
Runtime data plane
runtime-agentDocker proxyruntime_nodes
infrastructure
PostgreSQLClickHouseRedisKafkaMeilisearchLGTM
Synchronous domain ownership with asynchronous, replay-safe orchestration.

Where to go next

Start with the quickstart, then create your first workflow. For implementation detail, read the architecture and replay-safety model.