Environment variables¶
The container honours a small set of bootstrap env vars. All have safe defaults — you only need to touch them when running the install script.
Boot-time¶
| Variable | Default | Purpose |
|---|---|---|
ORCHESTRATOR_DATA_DIR |
/var/lib/orchestrator |
Root for the SQLite DB, blobs, runs, logs, csv_cdm, indexes. Persistent — bind-mount this from the host. |
ORCHESTRATOR_LISTEN_PORT |
8000 |
Port gunicorn binds inside the container. The installer maps this to the same host port (override with the same name when running install-etl-orchestrator.sh). |
ORCHESTRATOR_DB_PATH |
<DATA_DIR>/orchestrator.sqlite |
Override only if you need to point at a different DB file. |
ORCHESTRATOR_CONTAINER_SOCKET |
(auto) |
Path to the docker / podman socket. Probed in order: /var/run/docker.sock, /run/podman/podman.sock, $XDG_RUNTIME_DIR/podman/podman.sock. Override only if probing finds nothing. |
Installer-only (host-side)¶
These are read by install-etl-orchestrator.sh and persisted to
bin/etlo.config for the lifecycle script:
| Variable | Default | Purpose |
|---|---|---|
ORCHESTRATOR_DATA_DIR |
/var/lib/orchestrator |
Host path to bind-mount as /var/lib/orchestrator inside the container. |
ORCHESTRATOR_LISTEN_PORT |
8000 |
Host port to publish. |
ORCHESTRATOR_CONTAINER_NAME |
etl-orchestrator |
Container name. Override when running multiple installs on the same host. |