Operations

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

VariableDefaultDescription
DATABASE_URL—PostgreSQL or PgBouncer connection string (required)
REDIS_URL—Redis connection string (optional, enables fast dispatch)
GRPC_BIND_ADDR0.0.0.0:50051gRPC server bind address
HTTP_BIND_ADDR0.0.0.0:8080HTTP server bind address (health/metrics)
LOG_LEVELinfoLog level: trace, debug, info, warn, error
LOG_FORMATcompactOutput format: compact, json, pretty, bunyan
ORCHER_ORCHESTRATOR_CONFIG—Path to TOML config file (optional)

CLI Flags

1
orchestrator [OPTIONS]
2
3
Options:
4
-c, --config <FILE> Configuration file path
5
--grpc-addr <ADDR> gRPC server bind address
6
--http-addr <ADDR> HTTP server bind address
7
--database-url <URL> Database URL
8
--coordination-mode <MODE> Workflow coordination mode
9
--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]
2
grpc_addr = "0.0.0.0:50051"
3
http_addr = "0.0.0.0:8001"
4
max_concurrent_streams = 1000
5
6
[orchestrator]
7
max_workers = 100
8
max_concurrent_tasks = 1000
9
heartbeat_timeout_secs = 90
10
11
[storage]
12
database_url = "postgresql://orcher:orcher@localhost:6432/orcher"
13
redis_url = "redis://localhost:6379"
14
15
[polling]
16
claim_timeout_secs = 300
17
poll_timeout_secs = 60
18
reclaim_interval_secs = 10
19
enable_notifications = true
20
batch_claim_size = 10
21
22
[timeout_watcher]
23
enabled = true
24
poll_interval_secs = 30
25
batch_size = 100
26
grace_period_secs = 5
27
28
[workflow_retry]
29
enabled = true
30
default_max_attempts = 3
31
default_initial_backoff_secs = 1
32
default_backoff_multiplier = 2.0
33
default_max_backoff_secs = 300
34
35
[background_jobs]
36
metrics_enabled = true
37
metrics_interval_secs = 3600
38
retention_enabled = true
39
retention_interval_secs = 86400
40
41
[background_jobs.retention_days]
42
workflow_executions = 90
43
execution_logs = 30
44
journal_entries = 90
45
task_executions = 90
46
outbox_queue = 7

Next Steps