Skip to content

Chronicle Workbench

Chronicle Workbench

Inspect Chronicle from a local browser

Chronicle Workbench provides a bundled local browser surface for authorized inspection of Chronicle runtime state and preview of supported projection behavior.

Chronicle and its bundled local Workbench are available as MIT-licensed self-hosted software; authorized local use is separate from paid Cratis support, hosted coordination, or managed operational responsibility.

  1. Pull and start the current development image with Chronicle available only on this machine. MongoDB remains internal to the container. Pin a released version in project-owned configuration when repeatability matters.

    Terminal window
    docker run --pull=always --rm -d --name chronicle \
    -p 127.0.0.1:35000:35000 \
    cratis/chronicle:latest-development
  2. Wait for the local health endpoint to report readiness. The development image uses a self-signed certificate, so this command disables certificate verification only for this local check.

    Terminal window
    curl --insecure --fail --retry 30 --retry-all-errors --retry-delay 1 \
    https://localhost:35000/health

    Continue when the response prints Healthy.

  3. Open https://localhost:35000 in a browser and follow the authentication flow shown by the local development image. Browser handling of its self-signed certificate varies by environment.

  4. Select the event store and namespace you are authorized to inspect.

  5. Review only the runtime state and projection-preview paths needed for the evaluation.

  6. Stop and remove the container when finished.

    Terminal window
    docker rm -f chronicle

Connected clients

Review the clients currently represented by the selected local runtime scope.

Stores and namespaces

Confirm the exact event store and namespace before interpreting runtime state.

Observer state

Inspect the status presented for observers and recorded failed partitions.

Read models

Inspect the read-model instances exposed by the selected runtime scope.

Projection preview

Preview the projection behavior supported by the running Chronicle image.