Server configuration
Every setting Orion has, with its real default and its environment variable, one page per config section. orion-server with no config file starts and works; these pages are what you change for anything beyond a single-node development instance. A ready-to-edit file carrying the same values is config.toml.example, which the Docker image ships at /app/config.toml.example.
| Configure… | Page |
|---|---|
| Resolution, files, and validation | How settings are resolved |
| Production strictness | Deployment environment |
| Environment-specific values and secrets | Vars and secrets |
| HTTP, TLS, compression, and API docs | Server settings |
| SQLite, PostgreSQL, or MySQL | Storage settings |
| Multiple replicas and Redis | Cluster settings |
| Engine reload, connector failure, and the circuit breaker | Engine settings |
| Data-plane body size | Ingest settings |
| Async traces and the dead-letter queue | Trace queue settings |
| How traces are persisted | Trace persistence settings |
| Audit retention | Audit log settings |
| Query safety bounds | Query and write bounds |
| Scheduled (cron) channels | Cron scheduler settings |
| Kafka ingestion and broker auth | Kafka settings |
| Custom task functions in WebAssembly | Plugin settings |
| ONNX models and the artifact cache | Model settings |
| Admin API keys | Admin authentication settings |
| JWKS egress policy | JWT verification settings |
| OAuth2 token-endpoint egress policy | Inbound OAuth2 sign-in settings |
| Browser origins | CORS settings |
| Platform rate limits and trusted proxies | Rate limit settings |
| Which channels a node serves | Channel filter settings |
| Logs and Prometheus metrics | Logging and metrics settings |
| OpenTelemetry export | Tracing settings |
Related
- Production checklist: which of these settings to change before an instance takes real traffic.
- Secure an instance: the security settings in context, with the reasoning.
orion-servercommands:validate-config,migrate, and the rest.- Environment variables: every way the process environment reaches a setting.
Last verified 14 September 2026