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.
| Flag | Default | Description |
|---|---|---|
--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.
| Variable | Maps to |
|---|---|
ZISK_COORDINATOR_BINARY | Path to a pre-built zisk-coordinator binary (install-time only). |
ZISK_COORDINATOR_CONFIG | Read 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_HOME | Override the bundle root (where the toolchain and key bundle live). |
ZISK_CACHE_DIR | Override 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.