EKOSdocs
Docs / Configuration Build

Environment Variables

Every variable EKOS reads.

Variable Description Default
EKOS_CONFIG Path to ekos.toml (used when --config is absent) ./ekos.toml
EKOS_WORKSPACE Workspace for ekos mcp serve when no --workspace is given current dir
EKOS_LOG Log filter, overrides [workspace] log-level from config
EKOS_LOG_FORMAT pretty or json from config
EKOS_MCP_TOKEN Bearer token for --tcp / --http when --token-file is absent unset
ANTHROPIC_API_KEY Key for provider = "anthropic" —
OPENAI_API_KEY Key for provider = "openai" (and OpenAI embeddings) —
OPENAI_BASE_URL OpenAI-compatible host when [llm] base-url is unset OpenAI
OLLAMA_BASE_URL Ollama endpoint local Ollama
OLLAMA_MODEL Ollama model when [llm] model is unset —
OLLAMA_NUM_CTX Ollama num_ctx when [llm] context-window is unset 8192
EKOS_GITHUB_OWNER, EKOS_GITHUB_REPO Enable the GitHub connector unset
EKOS_GITHUB_TOKEN Optional GitHub token unset
EKOS_GITHUB_PER_PAGE, EKOS_GITHUB_MAX_PAGES Paging limits connector defaults
EKOS_CONFLUENCE_BASE_URL, EKOS_CONFLUENCE_SPACE Enable the Confluence connector unset
EKOS_CONFLUENCE_TOKEN Optional Confluence token unset
EKOS_CRYPTO_EXPORT_DIR Enable the crypto connector unset
EKOS_TREASURY_ADDRESS, EKOS_TREASURY_CHAIN_ID Enable the DAO treasury connector (RFC 0032) unset
EKOS_TREASURY_EXPLORER_URL, EKOS_TREASURY_API_KEY Explorer endpoint (default: Etherscan multichain v2) and key default URL / unset
EKOS_SNAPSHOT_SPACE Enable the Snapshot governance connector, e.g. ens.eth (RFC 0032) unset
EKOS_SNAPSHOT_HUB_URL Snapshot GraphQL endpoint https://hub.snapshot.org/graphql
EKOS_CLICKHOUSE_URL, _USER, _PASSWORD, _DATABASE ClickHouse connection unset

The name of the LLM key variable is configurable: [llm] api-key-env = "OPENCODE_API_KEY" reads whichever variable you name.

Prefer environment variables (or a secret manager) to putting keys in ekos.toml, which is usually committed.