Skip to content

Configuration

Susant Sahani edited this page Oct 18, 2026 · 1 revision

Configuration

This is a partial list of settings that are documented in the repo. The full set is in docs/ and charts/zorvia/values.yaml; I did not enumerate every variable.

Helm values (top-level keys in charts/zorvia/values.yaml)

image, labMode, replicaCount, serviceAccount, rbac, auth, database, service, ingress, httpRoute, tls, devices, ha, persistence, resources, podDisruptionBudget, networkPolicy, mcp, api, atlas, kryton, extraEnv. Examples used in docs: auth.existingSecret, api.exposeHost, httpRoute.hostnames, httpRoute.gateway.create, networkPolicy.ingressFrom, mcp.enabled, mcp.disableTools.

Environment variables (documented in the repo)

Variable Purpose (source)
ZORVIA_LAB_MODE Allows default passwords and a shared API key; off in shipped manifests. Needs explicit 1 for lab setups that rely on defaults (changelog 0.4.0).
ZORVIA_JWT_SECRET Must be at least 32 bytes outside lab mode (changelog 0.4.0).
ZORVIA_EXPERIMENTAL Enables Experimental features (GPU/SR-IOV, VMware import, fleet, golden pipeline, cross-cluster DR).
ZORVIA_DATABASE_URL Use PostgreSQL instead of the default SQLite (docs/POSTGRES.md). ZORVIA_DATABASE_IMPORT=1 is the optional one-time import.
ZORVIA_OIDC_ENABLED Turns on OIDC SSO (Beta); ZORVIA_OIDC_ISSUER, _CLIENT_ID, _CLIENT_SECRET, _REDIRECT_URI, _SCOPES, ZORVIA_OIDC_GROUP_ROLES apply only when enabled (docs/OIDC.md).
ZORVIA_MCP_ENABLED, ZORVIA_MCP_DISABLE_TOOLS MCP endpoint and tool withholding (docs/MCP.md).
ZORVIA_URL, ZORVIA_TOKEN Used by zorvia mcp to reach the server.
ZORVIA_H2KVM_IMAGE, ZORVIA_H2KVM_INIT_IMAGE, ZORVIA_IMPORT_CONCURRENCY, ZORVIA_IMPORT_BOOT_TIMEOUT_SECS VMware import Jobs; concurrency default 2, boot timeout default 600 s (range 30-3600) (docs/VM_IMPORT.md).
ZORVIA_WEB_DIR Location of the built web console (set in the release image).
ZORVIA_BACKUP_S3_*, ZORVIA_BACKUP_LOCK_MODE, ZORVIA_BACKUP_LOCK_DAYS Off-cluster S3 backups (docs/OFFCLUSTER_BACKUP.md).
ZORVIA_KEY_FILE, ZORVIA_KEY_ID, ZORVIA_VAULT_* Key provider for sealing TOTP secrets: local key or Vault Transit (docs/KEY_PROVIDER.md).
ZORVIA_TLS_RELOAD_SECS Certificate hot reload interval.
KRYTON_URL, KRYTON_TOKEN, KRYTON_PROJECT, KRYTON_TIMEOUT_SECS, KRYTON_TLS_INSECURE Kryton (Windows) integration; unset KRYTON_URL disables it (docs/KRYTON_INTEGRATION.md).
ATLAS_URL Atlas storage integration (Beta); empty means off (docs/ATLAS_INTEGRATION.md).

Ports

30152 (cluster HTTPS front door), 5151 (in-pod listen), 8080 (config-file default when --port is omitted).

Feature maturity

GA, Beta, Experimental and Model-only levels are listed in docs/FEATURE_MATURITY.md; a running API reports them at GET /api/v1/features.

Clone this wiki locally