Quickstart | Docs · Chronoverse

Run the complete development stack with Docker Compose. Docker builds the Go services, workers, database migration job, and dashboard locally.

Prerequisites

Docker Engine with Compose support.
Enough memory for PostgreSQL, ClickHouse, Kafka, Redis, Meilisearch, LGTM, the application services, and workers.

Start the stack

git clone https://github.com/hitesh22rana/chronoverse.git
cd chronoverse
scripts/compose/init-env.sh
scripts/compose/up.sh

Compose automatically reloads the gitignored .env file for later commands and restarts. Preserve it while existing encrypted sessions must remain valid.

Verify readiness

docker compose -f compose.dev.yaml ps
docker compose -f compose.dev.yaml logs -f init-database-migration

The development endpoints are:

Surface	URL
Dashboard	`http://localhost:3001`
HTTP API	`http://localhost:8080`
LGTM Grafana	Not host-published by default
gRPC services	`localhost:50051` through `localhost:50055`

To open Grafana on the Docker host loopback interface, apply the opt-in override and sign in with admin / chronoverse-local-grafana-password:

docker compose -f compose.dev.yaml -f compose.grafana.yaml up -d lgtm

Startup is dependency ordered

Certificates, infrastructure health, Kafka topics, and database migrations must complete before domain services and workers become ready.

Stop the stack

docker compose -f compose.dev.yaml down

Use down -v only when you intentionally want to delete local data and certificate volumes.