Skip to content

Configuration

Chronicle Server can be configured using a chronicle.json file or environment variables. Environment variables take precedence over file-based configuration, which is useful for containerized deployments.

{
"managementPort": 8080,
"port": 35000,
"storage": {
"type": "MongoDB",
"connectionDetails": "mongodb://localhost:27017"
}
}
SectionDescription
Root propertiesPorts and health check endpoint
FeaturesAPI, Workbench, and OAuth authority toggles
StorageStorage provider configuration
ObserversRetry and timeout settings
Read modelsReplay retention for replay-generated read model versions
EventsEvent queue configuration
AuthenticationExternal authority and default admin settings
TLSgRPC TLS certificate configuration
Workbench TLSDedicated Workbench TLS and certificate configuration
Identity Provider CertificateDedicated certificate configuration for internal OAuth authority