Configuration
Set reachable callback addresses, execution timeouts, retry budgets, and storage for your deployment.
Environment Variables
API and Webhooks
| Variable | Default | Description |
|---|---|---|
API_HOST | 0.0.0.0 | HTTP listen host |
API_PORT | 8080 | HTTP API port |
WEBHOOK_BASE_URL | http://localhost:8080 | Base URL the engine uses to construct async callback URLs. Must be reachable from your Step handlers. |
LOG_LEVEL | info | debug, info, warn, error |
Step Execution
| Variable | Default | Description |
|---|---|---|
STEP_TIMEOUT | 30000 | Global Service Step timeout fallback (ms). Overridden per action by http.invoke.timeout and http.compensate.timeout. |
Caching
| Variable | Default | Description |
|---|---|---|
TIMEBOX_CACHE_SIZE | 32768 | Maximum current-state cache entries retained in memory |
Retry Defaults
Applied when a Step omits retry fields or sets them to zero:
| Variable | Default | Description |
|---|---|---|
RETRY_MAX_RETRIES | 10 | Default max retries (cannot be 0) |
RETRY_INITIAL_BACKOFF | 1000 | Initial backoff in milliseconds (must be > 0) |
RETRY_MAX_BACKOFF | 60000 | Backoff cap in milliseconds (must be >= RETRY_INITIAL_BACKOFF) |
RETRY_BACKOFF_TYPE | exponential | fixed, linear, or exponential |
Invalid retry defaults fail engine startup.
Memoization
Applied when a memoized Step omits memo_ttl or sets it to zero:
| Variable | Default | Description |
|---|---|---|
MEMO_TTL | 86400000 | How long memoized results stay reusable, in milliseconds |
Raft Storage
| Variable | Description |
|---|---|
RAFT_NODE_ID | Local node identifier |
RAFT_ADDRESS | Local Raft listen address (e.g. 127.0.0.1:9701) |
RAFT_DATA_DIR | Durable local state directory |
RAFT_SERVERS | Bootstrap cluster members (e.g. node1=host1:9701,node2=host2:9702) |
RAFT_LOG_TAIL_SIZE | Number of recent write-ahead log entries retained in memory (default 20480) |
See Clustering for multi-node setup, health checks, and leader-aware routing.
Security
Deploy the engine behind an authenticated reverse proxy. Network isolation or mTLS provides service-to-service protection in production.
Script Steps run inside the engine, so use them only for trusted scripts.