Reference

Environment variables

The environment variables the binaries read, and the ones the node sets for its runtime.

Read by the CLI and the server

VariableUsed byWhat
OZ0_CONTEXTorchestrator-zeroPath to the operator's CLI context; same as --context
OZ0_DBserver init, server startPostgreSQL URL of the management database; same as --db
OZ0_RUNTIME_BUNDLEorchestrator-zero devThe runtime bundle the dev node uses

Read by the node

VariableUsed byWhat
OZ0_JOIN_TOKENorchestrator-zero-node joinThe join token; same as --token, and keeps it out of your shell history

Set by the node for its runtime

The node's supervisor sets these for the agent runtime, so unmodified SDKs talk to the local proxies:

VariableWhat
ANTHROPIC_BASE_URLThe node's local LLM proxy, for Anthropic's API
OPENAI_BASE_URLThe node's local LLM proxy, for OpenAI-compatible APIs

The API key the runtime sees is a per-start token for the local proxy, not a provider key. Tool processes get a minimal environment of their own, plus what the manifest sets in env.

For development

VariableWhat
OZ0_TEST_POSTGRES_URLRuns the store and cluster tests against PostgreSQL as well as SQLite
Copyright © 2026