Configuration

Set reachable callback addresses, execution timeouts, retry budgets, and storage for your deployment.

Environment Variables

API and Webhooks

VariableDefaultDescription
API_HOST0.0.0.0HTTP listen host
API_PORT8080HTTP API port
WEBHOOK_BASE_URLhttp://localhost:8080Base URL the engine uses to construct async callback URLs. Must be reachable from your Step handlers.
LOG_LEVELinfodebug, info, warn, error

Step Execution

VariableDefaultDescription
STEP_TIMEOUT30000Global Service Step timeout fallback (ms). Overridden per action by http.invoke.timeout and http.compensate.timeout.

Caching

VariableDefaultDescription
TIMEBOX_CACHE_SIZE32768Maximum current-state cache entries retained in memory

Retry Defaults

Applied when a Step omits retry fields or sets them to zero:

VariableDefaultDescription
RETRY_MAX_RETRIES10Default max retries (cannot be 0)
RETRY_INITIAL_BACKOFF1000Initial backoff in milliseconds (must be > 0)
RETRY_MAX_BACKOFF60000Backoff cap in milliseconds (must be >= RETRY_INITIAL_BACKOFF)
RETRY_BACKOFF_TYPEexponentialfixed, linear, or exponential

Invalid retry defaults fail engine startup.

Memoization

Applied when a memoized Step omits memo_ttl or sets it to zero:

VariableDefaultDescription
MEMO_TTL86400000How long memoized results stay reusable, in milliseconds

Raft Storage

VariableDescription
RAFT_NODE_IDLocal node identifier
RAFT_ADDRESSLocal Raft listen address (e.g. 127.0.0.1:9701)
RAFT_DATA_DIRDurable local state directory
RAFT_SERVERSBootstrap cluster members (e.g. node1=host1:9701,node2=host2:9702)
RAFT_LOG_TAIL_SIZENumber 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.