Skip to main content

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. The log level is the exception: RUST_LOG wins over --log-level.

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. The log level is the exception: a set RUST_LOG wins over both --log-level and [logging].level.

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.

FlagDefaultDescription
--config <PATH>(unset)TOML configuration file, read after the well-known paths. Env: ZISK_COORDINATOR_CONFIG.
-a, --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. Env: RUST_LOG. Overrides [logging].level, but when RUST_LOG is set, RUST_LOG decides the level even if the flag is passed.

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, except for RUST_LOG, which wins over --log-level.

VariableMaps to
ZISK_COORDINATOR_BINARYPath to a pre-built zisk-coordinator binary (install-time only).
ZISK_COORDINATOR_CONFIGRead by the binary as --config. The install script also reads it, as the coordinator.toml to copy into /etc/zisk/.
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). Wins over --log-level and the TOML.
ZISK_HOMEOverride the bundle root (where the toolchain and key bundle live).
ZISK_CACHE_DIROverride the cache directory for registered guest ELFs (default: ${ZISK_HOME:-$HOME/.zisk}/cache).

For worked invocations combining these flags and env vars, see Examples on the Usage page.