Orchestrator Configuration
The orchestrator is configured entirely via environment variables and CLI flags. Environment variables take precedence over defaults; CLI flags take precedence over environment variables.
Environment Variables
| Variable | Default | Description |
|---|---|---|
DATABASE_URL | — | PostgreSQL or PgBouncer connection string (required) |
REDIS_URL | — | Redis connection string (optional, enables fast dispatch) |
GRPC_BIND_ADDR | 0.0.0.0:50051 | gRPC server bind address |
HTTP_BIND_ADDR | 0.0.0.0:8080 | HTTP server bind address (health/metrics) |
LOG_LEVEL | info | Log level: trace, debug, info, warn, error |
LOG_FORMAT | compact | Output format: compact, json, pretty, bunyan |
ORCHER_ORCHESTRATOR_CONFIG | — | Path to TOML config file (optional) |
CLI Flags
1orchestrator [OPTIONS]23Options:4 -c, --config <FILE> Configuration file path5 --grpc-addr <ADDR> gRPC server bind address6 --http-addr <ADDR> HTTP server bind address7 --database-url <URL> Database URL8 --coordination-mode <MODE> Workflow coordination mode9 --log-level <LEVEL> Log level [default: info]10 --log-format <FORMAT> Log format [default: compact]TOML Configuration
For complex deployments, use a TOML configuration file:
1[server]2grpc_addr = "0.0.0.0:50051"3http_addr = "0.0.0.0:8001"4max_concurrent_streams = 100056[orchestrator]7max_workers = 1008max_concurrent_tasks = 10009heartbeat_timeout_secs = 901011[storage]12database_url = "postgresql://orcher:orcher@localhost:6432/orcher"13redis_url = "redis://localhost:6379"1415[polling]16claim_timeout_secs = 30017poll_timeout_secs = 6018reclaim_interval_secs = 1019enable_notifications = true20batch_claim_size = 102122[timeout_watcher]23enabled = true24poll_interval_secs = 3025batch_size = 10026grace_period_secs = 52728[workflow_retry]29enabled = true30default_max_attempts = 331default_initial_backoff_secs = 132default_backoff_multiplier = 2.033default_max_backoff_secs = 3003435[background_jobs]36metrics_enabled = true37metrics_interval_secs = 360038retention_enabled = true39retention_interval_secs = 864004041[background_jobs.retention_days]42workflow_executions = 9043execution_logs = 3044journal_entries = 9045task_executions = 9046outbox_queue = 7Next Steps
- Docker Overview — Quick start and Docker Compose services
- Production — Production Dockerfile and full production stack
- Troubleshooting — Health checks, volumes, and common issues
- Configuration Reference — Full configuration reference