Configuration reference
You configure VoisX Orchestrate through the Helm chart's values. Keep your settings in your own values file, for example orchestrate-values.yaml, and pass it on every install and change. This page covers the values a customer sets. Leave anything not listed here at its default.
Many features are off by default and stay off until you set their values: code agents, channels, the SIP gateway, hybrid sites, multi-tenancy, PostgreSQL high availability, backups and metrics. With them off, the chart renders nothing for them.
Apply a change
Edit your values file, then apply it with voisctl from the bundle of the version you run:
./voisctl upgrade --bundle ./bundle --keys ./keys \
--registry registry.example.com \
--registry-user <push-account> --registry-password <password> \
--kube-context <your-context> --namespace vois-orchestrate \
-f orchestrate-values.yaml --force
voisctl keeps the values already on the install, including the credentials it generated, applies your file on top, pins every image to its signed digest again, and checks the result.
You can also use Helm directly with the chart from the same bundle:
helm upgrade vois-orchestrate ./bundle/chart/vois-orchestrate-<version>.tgz \
--kube-context <your-context> --namespace vois-orchestrate \
--reset-then-reuse-values -f orchestrate-values.yaml --wait
A helm upgrade without --reset-then-reuse-values and without your full values file resets every value to the chart default. That empties your secrets and image pins. Services then fail authentication, often well after the upgrade reports success. Always keep the previous values, or pass your complete values file.
Security guard
The chart refuses to install or upgrade while a required credential is empty, or while a well-known default password is still in place, and lists each one. security.allowInsecureDefaults: true turns the guard off. It is for development only.
Images and registries
| Value | Default | What to set |
|---|---|---|
image.registry | empty, required | Your registry host, for example registry.example.com. |
image.repository | vois-orchestrate | Your registry project. |
image.tag | empty | Empty means the release the chart came from. |
image.digests | empty | Leave empty. voisctl sets a digest for each Orchestrate image. |
image.pullPolicy | IfNotPresent | Always or IfNotPresent. |
imagePullSecrets | empty | Names of docker-registry Secrets in the namespace, for a private registry project. |
postgres.image, temporal.image, temporal.uiImage, opa.image, livekit.image, keycloak.image, qdrant.image, redis.image, minio.image | public image names | The copies in your registry. voisctl sets and pins them. See Install. |
Model registry
Models you deploy from the catalog run from images in your registry.
| Value | Default | What to set |
|---|---|---|
modelRegistry.url | empty | Registry host, or host:port, with no scheme. It must be an address your nodes can pull from. Until you set it, model builds fail with a message that names it. |
modelRegistry.project | vois-orchestrate | The registry project for model images. |
modelRegistry.imagePullSecrets | empty | Pull Secret names for model images, if the project is private. |
modelRegistry.apiUrl | empty | The address the deployment controller uses to look up image digests. Empty means https://<modelRegistry.url>. |
modelRegistry.caCertSecret | empty | A Secret with key ca.crt, for a registry whose certificate comes from your own CA. |
modelRegistry.credentialsSecret | empty | A pull Secret the deployment controller uses to look up image digests in a private model project. Needed once the project stops answering anonymous pulls. |
modelRegistry.purgeCredentialsSecret | empty | A registry account that may list and delete repositories, so that purging an organization also removes its images. Without it the purge leaves them and names each one. |
modelRegistry.scanner.url | empty | Your registry's vulnerability scanner (Trivy) adapter. The System page reads the age of its database from it. Empty: the page says scanning isn't configured. |
modelRegistry.scanner.maxDbAgeDays | 30 | A scanner database older than this is shown as stale. |
modelIntegrity.enforcement | warn | warn deploys model images that have no build record from this platform and records them. enforce refuses them. An image whose digest doesn't match what this platform built is refused either way. |
runtimeBases.registry, runtimeBases.tag | empty | Where model builds take their prebuilt base images from. voisctl sets these to the copies the bundle carries, so models from the local model store build with no internet. |
buildImages.kaniko, buildImages.busybox, buildImages.mc | empty | The build tool images. voisctl sets them to the bundle's copies. |
Secrets
voisctl install generates every credential and keeps them in the Secret vois-orchestrate-install-values. With plain Helm, voisctl secrets generate --out values-secrets.yaml writes the same file. Set these yourself only if you manage credentials another way:
| Value | Used for |
|---|---|
postgres.password, postgres.appPassword, postgres.keycloakPassword, postgres.auditPassword | The bundled PostgreSQL. Applied only when PostgreSQL first creates its data. Changing them later breaks the services' connections. |
keycloak.adminPassword | Keycloak's own administrator. |
keycloak.consoleAdminPassword | The first console user, admin. |
keycloak.apiClientSecret | The API's client in Keycloak, used to search users, send invitations and manage identity providers. |
orchestrationWorker.apiKey, realtimeAgentWorker.apiKey, ragIngestion.apiKey, eval.apiKey | The workers' keys for the Model Gateway. Each must start with vcpk_. |
internalAuth.ragIngestionSearchKey, internalAuth.auditReadKey, internalAuth.redisPassword, internalAuth.qdrantApiKey | Credentials between services inside the cluster. |
minio.accessKey, minio.secretKey | MinIO, which holds documents, model files and recordings. |
livekit.apiKey, livekit.apiSecret | The LiveKit key pair for voice sessions. |
web.nextAuthSecret | Signs console sessions. If it is empty, every upgrade signs everyone out. |
Some credentials are generated by the chart on first install and kept across upgrades, so you don't set them: the policy bundle token, the code agent ingress key, the Temporal payload key, the audit keys, the site CA and the SIP gateway's key.
Rotating a worker key. Change its value and upgrade. On start-up the API rotates the stored key in place and keeps the old one working for 60 minutes while the workers restart. A value without the vcpk_ prefix is refused with an error in the log.
PostgreSQL is never published outside the cluster. Limit who can run kubectl exec and read Secrets in the vois-orchestrate namespace.
Cluster platform
| Value | Default | What it does |
|---|---|---|
platform.openshift | false | true on OpenShift: restricted pod security, no fixed user ids, OpenShift Routes for exposure, and dedicated service accounts for the few pods that need wider SCCs. |
podSecurity.restricted | false | Runs every pod under the Kubernetes "restricted" Pod Security Standard. Recommended for every new install. On an existing install, change the ownership of each data volume first. LiveKit uses the host network, which the restricted standard forbids. |
podSecurity.runAsUser | 10001 | The user id every pod runs as, when restricted. |
persistence.storageClassName | empty | The StorageClass for every volume. Empty uses the cluster default. - binds to pre-created volumes. Each store can override it with <store>.storageClassName. |
See the platform guides that come with the bundle for EKS, GKE, OpenShift and other clusters.
Exposure
Nothing is reachable from outside the cluster unless you turn it on. Reaching an install that publishes nothing means kubectl port-forward.
| Value | Default | What it does |
|---|---|---|
exposure.mode | none | none, ingress, route (OpenShift), loadBalancer or nodePort. |
exposure.className | empty | ingress mode: the IngressClass. Empty uses your cluster's default class. |
exposure.loadBalancerIP | empty | loadBalancer mode: a pre-assigned address, for MetalLB or a hardware balancer. |
exposure.annotations | empty | Annotations added to everything the exposure settings create. |
exposure.tls.mode | certManager | ingress and route modes: certManager, secret or none. See TLS. |
exposure.tls.clusterIssuer | empty | certManager mode: the name of your ClusterIssuer. Required in that mode. |
exposure.tls.secretName | empty | secret mode: the kubernetes.io/tls Secret you created. Required in that mode. |
Modes
| Mode | Use it when | Result |
|---|---|---|
ingress | Your cluster runs an ingress controller. | An Ingress per component, on its hostname, with TLS. |
route | OpenShift (platform.openshift: true). | An OpenShift Route per component, with TLS. |
loadBalancer | You have MetalLB or a hardware load balancer. | An extra Service of type LoadBalancer per component, named <component>-external. Plain HTTP. |
nodePort | You have neither. | An extra NodePort Service per component. Plain HTTP. |
none | Default. | Nothing is published. |
In loadBalancer and nodePort modes, set each component's host to the address or DNS name people use to reach it. In nodePort mode, also set a fixed nodePort (30000 to 32767) for web and for api.
Components you can expose
Each component takes enabled, host, nodePort, loadBalancerIP and annotations under exposure.components.<name>.
| Component | What it is | Notes |
|---|---|---|
web | The console. | Its host becomes the console's URL and the API's allowed browser origin. Required in ingress mode. |
api | The Orchestrate API, including the Agent API, hosted chat, A2A and channel webhooks. | The console calls it from the browser, so expose it whenever you expose web. |
keycloak | Keycloak's sign-in pages. | Needed as soon as the console is exposed, because sign-in sends the browser there. In ingress mode only the sign-in paths are published, never Keycloak's admin console, and host can be the console's own host. In loadBalancer and nodePort modes the whole port is published, admin console included, so prefer ingress. |
model-gateway | The Model Gateway for your own applications and external agents. | Off by default. See The Model Gateway address. |
minio | Object storage, for direct browser upload and download. | The API already handles uploads and downloads, so most installs leave this off. |
livekit | LiveKit signalling, for voice sessions in a browser. | See Voice (LiveKit). |
Every other component can't be exposed. If you add any other name under exposure.components, the chart refuses to render and says why. This covers PostgreSQL, Redis, Qdrant, Open Policy Agent, Temporal and its web UI, the audit service, the knowledge-base search service, the License Service, every worker and the model predictors. Several of these have no authentication of their own. The SIP gateway and the site gateway have their own settings below.
The Model Gateway address
The Model Gateway's external address is a switch, and it is off by default. Orchestrate is built to run air-gapped, so nothing outside the cluster can call the gateway until you turn it on.
Turn it on when applications or agents that run outside the cluster need to call models through Orchestrate: a team's own service, an agent on a developer's laptop, or a code agent framework running on other infrastructure. Leave it off when everything that calls models runs inside the cluster. Orchestrate's own agents and workers reach the gateway inside the cluster either way.
To turn it on, set the component and a hostname of your own:
exposure:
components:
model-gateway:
enabled: true
host: orchestrate-gateway.internal.example.com
- The hostname can be internal-only. It only has to resolve and be reachable from wherever your applications run, such as your corporate network or a VPN. It doesn't need to be on the internet.
- It uses the same
exposure.modeand TLS settings as your other components. Withtls.mode: secret, make sure the certificate also covers this hostname. - Every call still needs an API key. Personal keys and agent keys are both accepted, and requests without a valid key get
401. - When it is on, the console shows the address on API keys > Agent keys and puts it in the code snippets. When it is off, the console says that no external gateway address is set.
- If the gateway is reachable at an address this chart didn't create, such as your own load balancer or API gateway, set
modelGateway.publicUrlinstead. The console then shows that address.
You can turn the switch on or off later with an upgrade. Turning it off removes the published address; keys stay valid for callers inside the cluster.
TLS
exposure.tls.mode | How it works |
|---|---|
secret | You create a kubernetes.io/tls Secret and name it in exposure.tls.secretName. One SAN or wildcard certificate can cover every hostname. Works on any network, including air-gapped ones. |
certManager | cert-manager issues a certificate for each hostname, through the ClusterIssuer in exposure.tls.clusterIssuer. Each component gets its own <component>-tls Secret. An ACME issuer needs internet access, so on an air-gapped network use a CA issuer. |
none | Plain HTTP, and the console's URL starts with http://. |
If a device in front of the cluster terminates TLS, none gives the console the wrong URL scheme. Contact us before you set it up that way.
Console
| Value | Default | When to set it |
|---|---|---|
web.nextAuthUrl | http://localhost:3001 | Only if the console is not exposed. It is the address people use to reach the console, such as a port-forward. |
web.apiUrl | empty | Only to override the API address the browser uses. Empty uses the exposed api host. |
web.additionalOrigins | empty | Extra browser origins the API accepts, besides the console's own URL. |
web.temporalUiUrl | empty | The link the console shows for the Temporal web UI. Never point it at a published address: the Temporal web UI has no sign-in. |
The console and API URLs have to agree with what the browser actually loads. If they don't, the console doesn't show an error. It shows pages whose panels are all empty.
Sign-in (Keycloak)
| Value | Default | What it does |
|---|---|---|
keycloak.publicUrl | empty | The Keycloak address a browser signs in at. Empty derives it from exposure.components.keycloak, or http://localhost:8180 for a port-forward. Set it only for an address this chart didn't create. |
keycloak.sslRequired | external | HTTPS for sign-in: external (except from private addresses), all or none. Applies when the realm is first created. |
keycloak.realmSync.enabled | true | After every install and upgrade, a job brings an existing realm up to date: redirect addresses, the API's client, groups and events. Turn it off only if you manage the realm yourself. |
keycloak.idpSecrets.enabled | true | Keeps identity providers' client secrets in a Kubernetes Secret that Keycloak reads as a vault. With it off, OpenID Connect providers with a client secret can't be saved from the console. |
keycloak.adminConsoleUrl | http://localhost:8180 | Where the console tells operators Keycloak's admin console is. |
See Identity and single sign-on.
Multi-tenancy
| Value | Default | What it does |
|---|---|---|
tenancy.mode | single | single: one organization per install. saas: many organizations on one install, isolated by PostgreSQL row-level security. |
tenancy.operatorRole | platform-operator | The realm role of platform operators in SaaS mode. |
tenancy.keycloakOrganizations | false | Create a Keycloak organization for each tenant. Needs Keycloak 26 with organizations enabled. |
See Multi-tenancy.
Models and routing
The Model Gateway routes each request to the model it names.
- Catalog models. A model you deploy from the Models page is routed automatically once it is ready.
- Static routes.
modelGateway.selfHostedModelslists extra routes, each with anameand anapiBase, for an OpenAI-compatible server you run yourself. Empty by default.
modelGateway:
selfHostedModels:
- name: "llama3.1:8b"
apiBase: "http://llm01.internal.example.com:11434/v1"
Static routes are sent without an API key, win over a catalog model with the same name, and are treated as self-hosted. Point them only at servers on your own network.
| Value | Default | What it does |
|---|---|---|
modelGateway.semanticCacheEmbeddingModel | empty | An embedding model the response cache uses to match similar prompts. Empty caches exact matches only. |
modelGateway.visionModels | empty | Self-hosted models that accept images. A request with an image for any other self-hosted model is refused, rather than answered by a model that never saw it. |
modelGateway.publicUrl | empty | The Model Gateway address shown with new agent keys, for agents outside the cluster. Empty derives it from the exposed model-gateway host, and shows no address when the gateway is not exposed. Display only. See The Model Gateway address. |
modelServing.gpu.nodeSelector, modelServing.gpu.tolerations | empty | Where GPU model deployments are scheduled. Empty tolerates the usual nvidia.com/gpu taint. |
modelServing.gpu.memoryGiB | 24 | The memory of one GPU on your nodes. A deploy whose weights don't fit the chosen GPU size is refused, with the size that would fit. |
modelServing.gpu.nodeInventory | true | Let the API read nodes and the namespace's ResourceQuota, so custom sizes and GPU types are checked against the cluster before anything is scheduled. Off, the scheduler decides. |
modelServing.gpu.typeLabel | nvidia.com/gpu.product | The node label that names each node's GPU model. The console offers only the types it finds. |
modelServing.gpu.maxPerProject | 8 | The most GPUs one project's deployments may hold, counted at their maximum replicas. Platform admins aren't capped. 0 turns the cap off. |
modelServing.vllm.variant | empty (CUDA) | cpu builds vLLM models from vLLM's CPU image, for an install without GPU nodes. See Sizes and GPUs. |
modelServing.byo.proxyProjects | empty | For your own serving containers: a map from a source registry to a pull-through proxy project in your registry, such as {"docker.io": "dockerhub-proxy"}. |
gpuSharing.mode | none | time-slicing or mig, to share GPUs between models. See GPU sharing. |
gpuSharing.timeSlicing.replicas | 4 | Shares per physical GPU, with time-slicing. |
gpuSharing.mig.strategy | mixed | mixed (each slice its own resource) or single. |
gpuSharing.devicePluginConfig.create | false | Render the NVIDIA device plugin's sharing config as a ConfigMap, for the plugin to load. |
modelStore.urlImport.allowedHosts | empty | Hosts models may be downloaded from into the local model store: exact names, or *.example.com. Empty turns Add from a URL off. See Your own models. |
modelStore.urlImport.maxBytes | 200 GiB | The largest file one URL import may download. |
agentTimezone | empty | The time zone agents are told the time in, when their organization sets none. Empty means Asia/Dubai. |
Model and voice catalog
| Value | Default | What it does |
|---|---|---|
voiceCatalog.seed | the two baseline speech models | Voices and speech models added to the catalog of a new install and built. [] adds none. Admins add more under Settings > Voice catalog. |
modelCatalog.seed | empty | Chat and embedding models from the curated library to add and build on start-up. |
modelCatalog.deploy | empty | Catalog models, of any kind, to deploy once built: shared, into the Default project, on this cluster. |
modelCatalog.rebuildOnRuntimeChange | empty | Runtimes, such as ollama or vllm, whose built models are rebuilt automatically, one at a time, when the release changes that runtime's base image. Their running deployments move to the new image. |
A model already in the catalog is never added twice.
External providers
externalProviders.enabled (default false) is the ceiling for calls to AI providers outside your cluster. While it is false, no model call leaves the cluster, whatever the console says. With it true, admins connect providers on Models > External providers, a platform admin can switch external providers off and on under Settings, and an organization can turn them off for its own projects. Neither can go past this value. See External providers.
modelGateway.anthropicApiKey and modelGateway.openaiApiKey are used only when external providers are on. Leave them empty otherwise.
Guardrails
modelGateway.guardrails sets the install's guardrail defaults, in the same shape as the chart's files/guardrails.example.json. A files/guardrails.json in the chart wins over it. Empty uses the built-in defaults.
modelGateway:
guardrails:
matrix:
completion: { credit_card: redact }
packs: [gulf, eu]
ignore_patterns: ["ORD-[0-9]{10}"]
Per organization, project, agent or version, use guardrail profiles in the console. See PII guardrails and Guardrail profiles.
Agent API and end-user chat
| Value | Default | What it does |
|---|---|---|
agentApi.webhookAllowedHosts | empty | Hosts an async agent run may call back with its webhook, comma-separated, with *.example.com for subdomains. Empty refuses every webhook. See Agent API. |
Channels
| Value | Default | What it does |
|---|---|---|
channels.outboundHosts | empty | Hosts the API may call for Teams, Slack and WhatsApp, comma-separated. Empty means no channel can be connected and nothing is sent: the air-gapped setting. |
channels.publicBaseUrl | the API's URL | The API's address as the vendors reach it. The webhook address is <this>/channels/<id>/events. |
channels.secretBackend | vault with code agents on | Where channel credentials go. |
channels.simulator | false | Allow simulator channels, for test installs only. |
The hosts each vendor needs are listed in Channels. Behind a proxy, set HTTPS_PROXY and NO_PROXY on the API.
Code agents
Code agents run your code, so they are off by default.
| Value | Default | What it does |
|---|---|---|
agents.enabled | false | Turns on code agents, agent keys' A2A surface, the agent edge, and the build and runtime namespaces. |
agents.networkPolicy.enforced | false | Your statement that the cluster enforces NetworkPolicy. Without it, deploys are refused. |
agents.networkPolicy.allowUnenforced | false | Deploy anyway on a cluster that doesn't enforce it. Development only: every such deployment is marked. |
agents.networkPolicy.privateEgressCidrs | empty | Private ranges an agent's network.egress may open, such as an internal CRM. Never list the cluster's pod, service or node ranges. |
agents.runtimeNamespace, agents.buildNamespace | vois-orchestrate-agents, vois-orchestrate-agent-builds | Where agents run and build. No platform Secret is mounted there. |
agents.build.harborProject | vois-orchestrate-agents | The registry project for agent images. |
agents.build.pushCredentialsSecret | harbor-agents-push-credentials | A docker config Secret in the build namespace that can push agent images and pull base images. |
agents.build.pipIndexUrl and related | empty | Your Python package mirror. |
agents.build.packageIndex.source | auto | auto uses your mirror if set, else the offline package index if on, else public PyPI. |
agents.build.egress | empty | Where build pods may connect: your registry and package index. With an enforcing engine and this empty, builds can't reach the registry. |
agents.build.maxConcurrent, agents.build.timeoutMinutes | 2, 45 | Builds at once across the install, and the longest one may take. |
agents.wheelhouse.enabled | false | The offline package index from the bundle. voisctl upgrade --bundle turns it on. |
agents.runtime.integrityEnforcement | enforce | Refuse agent images Orchestrate didn't build. |
agents.runtime.previousLiveWarmReplicas | 1 | Replicas kept on the previous live version for a fast rollback. |
agents.quotas.projectDefaults | empty | Code agent quotas for projects without their own. |
agents.a2a.grpc.enabled, agents.a2a.grpc.port | false, 50051 | Serve the A2A gRPC binding from the API. With ingress exposure and the API exposed, it is routed on the API host and cards list <api host>:443. See Agents calling agents. |
agents.a2a.grpc.publicAddress | empty | The host:port cards list for gRPC, for other exposure modes. Empty derives it from the API's ingress. |
agents.a2a.identity.installId, agents.a2a.identity.signingKey | empty | This install's A2A identity. Empty generates one on first install and keeps it. Set them only to carry an identity over to a rebuilt install. See Trusted installs. |
Code agents also need Vault roles for their sources, secrets and runtime keys. See Code agents.
Connectors and tool execution
| Value | Default | What it does |
|---|---|---|
toolExecution.sandbox.platformAddresses | true | Refuse every pod, node and service address in the platform's namespaces as a connector destination. The list is refreshed every 30 seconds. |
toolExecution.sandbox.blockedCidrs | empty | More ranges to refuse outright. |
toolExecution.networkPolicy.enabled | false | A NetworkPolicy on tool execution: it then reaches only the platform services it needs and the destinations below. |
toolExecution.networkPolicy.publicHttps | true | Allow 443 to public addresses, for SaaS connectors and OAuth providers. |
toolExecution.networkPolicy.egress | empty | Your databases and APIs, by cidr outside the cluster or by selector (to) inside it, with ports. On an air-gapped install list every database, REST API and MCP server. |
Phone calls (SIP)
| Value | Default | What it does |
|---|---|---|
sipGateway.enabled | false | Runs the SIP gateway. |
sipGateway.publicIp, sipGateway.mediaIp | empty | The addresses carriers reach for SIP and media. Empty means calls from inside the cluster only. |
sipGateway.publicHost | empty | Shown in the console as where to point a trunk. |
sipGateway.hostNetwork | false | Media on the node's own interfaces, the usual way a carrier reaches the RTP ports. Needs a node with a routable address. |
sipGateway.publicService.enabled | false | A LoadBalancer Service for SIP on 5060. |
sipGateway.rtpPortMin, sipGateway.rtpPortMax | 20000 to 20199 | The media ports, one even port per call. |
sipGateway.maxCalls, sipGateway.replicas | 50, 1 | Calls per gateway pod, and pods. |
sipGateway.codecs | PCMU,PCMA | G.711 µ-law and A-law. |
sipGateway.rtpStrictSource | true | Take media only from the address the far end's SDP names. |
sipGateway.tls.enabled, sipGateway.tls.secretName | false, empty | SIP over TLS on port 5061 (tls.port), with a kubernetes.io/tls Secret in the release namespace. |
sipGateway.tls.verifyPeer, sipGateway.tls.minVersion | true, TLSv1.2 | Check the carrier's certificate on outbound TLS, and the lowest TLS version. |
sipGateway.srtp | off | optional or required: encrypted media (SDES SRTP). Use it with TLS. |
Opening the SIP and RTP ports to your carrier is infrastructure work outside the chart. See Phone calls (SIP).
Hybrid sites
hybrid.gateway.enabled turns on the site gateway that sites on customer premises dial out to. Expose it with a TCP load balancer (hybrid.gateway.service.type: LoadBalancer), list its public name in hybrid.gateway.hosts, and set hybrid.gateway.publicUrl. See Hybrid sites.
Voice (LiveKit)
Voice sessions in the browser use LiveKit. The browser connects to LiveKit's signalling port through your ingress, and sends media straight to the node that runs LiveKit.
-
Set LiveKit's public hostname:
livekit:
publicHost: orchestrate-voice.example.comWith
ingressexposure and TLS, browsers connect overwss://. The chart sets one-hour proxy timeouts on LiveKit's Ingress for ingress-nginx, so long sessions aren't cut off. With another ingress controller, set the equivalent throughexposure.components.livekit.annotations. -
Open 7881/TCP and 7882/UDP from your users to the nodes that can run LiveKit.
| Value | Default | What it does |
|---|---|---|
livekit.publicHost | empty | The hostname browsers use for LiveKit signalling. Empty publishes nothing. |
livekit.nodeSelector | empty | Pins LiveKit to labelled nodes, so media ports stay on known addresses. |
livekit.stunServers | empty | STUN servers given to browsers. Empty gives them none that work, so media uses LiveKit's own node address, which clients on your network reach directly. Set an internal STUN server when clients are behind a NAT that needs one. |
livekit.publicStun | false | true lets LiveKit hand browsers its default public STUN servers when stunServers is empty. Only for an internet-connected install that accepts this. |
livekit.externalTurnServers | empty | TURN servers given to browsers, each with host, port, protocol, username and credential. The credential is sent to every browser as is. |
livekit.turn.* | off | LiveKit's built-in TURN server. Contact us before you turn it on. |
LiveKit uses a single pod on the node's host network, and it is replaced, not rolled, on a change. Voice is unavailable for everyone while it restarts. If LiveKit moves to another node, restart the voice worker too:
kubectl --context <your-context> -n vois-orchestrate rollout restart deployment/realtime-agent-worker
Governance
| Value | Default | What it does |
|---|---|---|
opa.bundlePolling.minDelaySeconds, opa.bundlePolling.maxDelaySeconds | 5, 15 | How often Open Policy Agent fetches the custom policies you save in the console. |
Custom policies, guardrail profiles, model access and compliance settings are stored in the database, so they carry across upgrades.
Audit log
| Value | Default | What it does |
|---|---|---|
audit.chainKey, audit.signingKey, audit.writeKey | generated | The chain's HMAC key, the Ed25519 key that signs checkpoints, and the key services use to write events. Generated once into the audit-keys Secret and kept. Set them, or audit.existingSecret, to bring your own. |
audit.chainPreviousKeys, audit.signingPreviousPublicKeys | empty | Old keys that must still verify, after a rotation. Never drop one while events signed with it are kept. |
audit.writerRole.enabled | true | The audit service connects as a role that can only read and add events. |
audit.checkpointIntervalSeconds | 300 | How often the chain head is signed, when it has moved. |
audit.retention.days, audit.retention.minDays | 0 (forever), 365 | How long events are kept, and the lowest the console may set. |
audit.export.sinks | empty | SIEM sinks managed here: syslog, webhook, Splunk HEC or S3. Shown read-only in the console. |
See Audit log.
Licence
| Value | Default | What it does |
|---|---|---|
license.secretName | empty | A Secret holding your licence under the key license.txt. |
license.storage.enabled | true | A small volume for a licence uploaded on the console's Licence page. Needs a default StorageClass. |
license.graceDays | 14 | Days after expiry during which everything keeps working, with a warning. |
license.revalidateSeconds | 600 | How often the License Service reads the licence again. |
There is no public key setting: the License Service trusts only the VoisX keys built into it. See Licence.
High availability and backups
| Value | Default | What it does |
|---|---|---|
availability.replicas | empty | Run stateless services more than once, for example { api: 2, web: 2, modelGateway: 2 }. Allowed: api, web, modelGateway, toolExecution, ragIngestion, audit, opa, orchestrationWorker, realtimeAgentWorker, eval. |
availability.podDisruptionBudgets | true | A PodDisruptionBudget for each service with two or more replicas. |
postgresHA.mode | off | PostgreSQL on CloudNativePG. A fresh install uses cnpg with postgresHA.bootstrap: initdb. An existing install moves over in two gated steps. |
postgresHA.instances | 3 | A primary and streaming replicas. |
postgresHA.synchronous.enabled | false | Synchronous replication, for no loss of acknowledged writes on failover. See Synchronous replication. |
postgresHA.synchronous.method, .number | any, 1 | Quorum (any) or priority (first), and how many standbys each commit waits for, 1 to instances - 1. |
postgresHA.synchronous.dataDurability | required | required blocks writes while too few standbys are up. preferred never blocks, and suspends the guarantee meanwhile. |
postgresHA.synchronous.allowWriteStalls | false | Needed for required with no spare standby, where routine restarts would stop all writes. The chart refuses that combination without it. |
postgresHA.synchronous.failoverQuorum | false | Wait rather than promote a replica that may lack a synchronous commit. Matters from 3 instances. |
backups.s3.* | empty | One S3-compatible target for every backup. |
backups.postgres, .qdrant, .minio, .redis, .license | PostgreSQL on, the rest off | What is backed up, when, and how many copies are kept. |
See High availability and backups.
Observability
| Value | Default | What it does |
|---|---|---|
observability.metrics.enabled | false | Prometheus metrics from the API and the Model Gateway, on a separate port (9464), with scrape annotations. |
observability.metrics.serviceMonitor.enabled | false | A prometheus-operator ServiceMonitor per service. Needs the operator's CRDs. |
observability.tracing.otlpEndpoint | empty | An OTLP/HTTP collector for traces. Empty sends none anywhere. |
Temporal
| Value | Default | What it does |
|---|---|---|
temporal.payloadEncryption.enabled | true | Every payload the orchestration engine stores is encrypted with AES-256-GCM by the services themselves, so its database and web UI hold only ciphertext. The key is generated once and kept, or comes from temporal.payloadEncryption.existingSecret. Losing every key makes running workflows unreadable. |
temporal.namespaceRetention | 24h | How long a closed run's history is kept. Applies when the namespace is first created. |
Projects
projects.purgeAfterHours (default 168) is how long a deleted project can be restored before it is purged. See Delete a project.
Storage
| Value | Default |
|---|---|
postgres.storageSize | 5Gi |
qdrant.storageSize | 5Gi |
minio.storageSize | 10Gi |
redis.storageSize | 1Gi |
postgresHA.storage.size | 10Gi per instance |
license.storage.size | 1Gi |
Every volume is ReadWriteOnce.
Set the sizes before the first install. Kubernetes doesn't let a chart change the volume size of an existing StatefulSet, so changing these values later makes the upgrade fail. To grow a volume later, resize its PersistentVolumeClaim directly, if your StorageClass allows expansion. The claims are named data-postgres-0, data-qdrant-0, data-minio-0 and data-redis-0.
Resources
The chart sizes components through four tiers. You can change the requests and limits of each tier.
| Tier | Default requests | Default limits | Used by |
|---|---|---|---|
resources.small | 100m CPU, 128Mi | 500m CPU, 256Mi | License Service, audit, eval worker, Open Policy Agent, LiveKit, Redis |
resources.medium | 250m CPU, 256Mi | 1 CPU, 512Mi | API, Model Gateway, console, orchestration worker, tool execution, deployment controller, knowledge-base ingestion, agent edge, Qdrant, MinIO |
resources.jvm | 500m CPU, 512Mi | 1 CPU, 1Gi | Keycloak |
resources.ml_inference | 500m CPU, 1Gi | 2 CPU, 2Gi | Realtime voice worker |
Models you deploy are sized separately, by the resource profile you choose when you deploy them. Code agents are sized by their runtime.resources profile. The SIP gateway has its own sipGateway.edgeResources and sipGateway.bridgeResources.
Other values
| Value | Default | Notes |
|---|---|---|
deploymentMode | standalone | Leave as standalone. |