---
title: 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.

## Example configuration

```json
{
  "managementPort": 8080,
  "port": 35000,
  "storage": {
    "type": "MongoDB",
    "connectionDetails": "mongodb://localhost:27017"
  }
}
```

| Section | Description |
| --- | --- |
| Root properties | Ports and health check endpoint |
| Features | API, Workbench, and OAuth authority toggles |
| Storage | Storage provider configuration |
| Observers | Retry and timeout settings |
| Read models | Replay retention for replay-generated read model versions |
| Events | Event queue configuration |
| Authentication | External authority and default admin settings |
| TLS | gRPC TLS certificate configuration |
| Workbench TLS | Dedicated Workbench TLS and certificate configuration |
| Identity Provider Certificate | Dedicated certificate configuration for internal OAuth authority |

## Topics

- [Configuration File](/chronicle/hosting/configuration/configuration-file/) - Structure and location of `chronicle.json`.
- [Root Properties](/chronicle/hosting/configuration/root-properties/) - Ports and health check settings.
- [Features](/chronicle/hosting/configuration/features/) - Toggle API, Workbench, and OAuth authority.
- [Storage](/chronicle/hosting/configuration/storage/) - Configure the storage provider and connection details.
- [Observers](/chronicle/hosting/configuration/observers/) - Retry and timeout settings for observer subscriptions.
- [Read Models](/chronicle/hosting/configuration/read-models/) - Configure replay retention for replay-generated read model versions.
- [Events](/chronicle/hosting/configuration/events/) - Configure event queues.
- [Authentication](/chronicle/hosting/configuration/authentication/) - External authority and default admin settings.
- [TLS](/chronicle/hosting/configuration/tls/) - Configure top-level gRPC TLS certificates.
- [Workbench TLS](/chronicle/hosting/configuration/workbench-tls/) - Configure Workbench TLS and certificates.
- [Identity Provider Certificate](/chronicle/hosting/configuration/identity-provider-certificate/) - Configure internal OAuth authority certificates.
- [Environment Variables](/chronicle/hosting/configuration/environment-variables/) - Configure with `Cratis__Chronicle__` settings.
- [Open Telemetry](/chronicle/hosting/configuration/open-telemetry/) - Export metrics, traces, and logs via OTLP.
- [Docker Configuration](/chronicle/hosting/configuration/docker/) - Configure Chronicle in Docker.
- [Configuration Precedence](/chronicle/hosting/configuration/configuration-precedence/) - How sources override each other.
- [Best Practices](/chronicle/hosting/configuration/best-practices/) - Recommended configuration guidelines.
- [Port Reference](/chronicle/hosting/configuration/port-reference/) - Ports exposed by Chronicle Server.
- [Job Throttling](/chronicle/hosting/configuration/job-throttling/) - Limit parallel job steps to control CPU usage.