CLI & environment
Documents the zisk-coordinator command-line flags and ZISK_COORDINATOR_* environment variables that override coordinator.toml values, with CLI flags winning over env vars, which win over the TOML.
zisk-coordinator is configured primarily through
coordinator.toml; this page documents the
escape hatches: command-line flags and environment variables that
override TOML values for one-off testing or for container
entrypoints. CLI flags win over env vars, which win over the TOML.
zisk-coordinator [OPTIONS]
CLI flags
The coordinator CLI is narrow on purpose — most settings live in the TOML, and the deploy scripts wire them via the systemd unit. Flags below override the config file for one-off testing or container entrypoints.
| Flag | Default | Description |
|---|---|---|
--config <PATH> | (unset) | TOML configuration file. |
--api-port <N> | (from TOML) | Override [server].port. |
--cluster-port <N> | (from TOML) | Override [coordinator].port. |
--metrics-port <N> | (from TOML) | Override [metrics].port. |
--log-level <LEVEL> | (from TOML) | trace/debug/info/warn/error. Equivalent to RUST_LOG. |
Environment variables
Useful in .env files read by the deploy install scripts, in
container env: blocks, or for one-off shell exports. CLI flags
win when both are set.
| Variable | Maps to |
|---|---|
ZISK_COORDINATOR_BINARY | Path to a pre-built zisk-coordinator binary (install-time only). |
ZISK_COORDINATOR_CONFIG | Path to a coordinator.toml to copy into /etc/zisk/ (install-time only). |
ZISK_COORDINATOR_API_PORT | [server].port |
ZISK_COORDINATOR_CLUSTER_PORT | [coordinator].port |
ZISK_COORDINATOR_METRICS_PORT | [metrics].port |
RUST_LOG | [logging].level and module-level filters (e.g. zisk_coordinator_server=debug,info). |
ZISK_HOME | Override the bundle root (where the toolchain and key bundle live). |
ZISK_CACHE_DIR | Override the cache directory for registered guest ELFs (default: under the working directory). |
For worked invocations combining these flags and env vars, see Examples on the Usage page.