Helm Values

All configurable Helm chart values for the ark-operator Helm chart.

All configurable values for the arkonis/ark-operator Helm chart.

helm repo add arkonis https://charts.arkonis.dev
helm show values arkonis/ark-operator

Core configuration

ValueDefaultDescription
taskQueueURL""Redis connection string for the task queue. Required. Example: redis.ark-system.svc.cluster.local:6379
triggerWebhook.url""Base URL of the webhook receiver exposed by the operator. Example: http://ark-operator.ark-system.svc.cluster.local:8092
replicaCount1Number of operator pod replicas.
namespaceark-systemNamespace where the operator is deployed.

API keys

ValueDefaultDescription
apiKeys.openaiApiKey""OpenAI API key. Injected into all agent pods as OPENAI_API_KEY.
apiKeys.anthropicApiKey""Anthropic API key. Injected into all agent pods as ANTHROPIC_API_KEY.
apiKeys.existingSecret""Name of an existing Secret containing API key env vars. If set, apiKeys.openaiApiKey and apiKeys.anthropicApiKey are ignored.

Agent pod configuration

ValueDefaultDescription
agentImageghcr.io/arkonis-dev/ark-runtime:latestContainer image for agent pods.
agentImagePullPolicyIfNotPresentImage pull policy for agent pods.
agentExtraEnv[]Additional environment variables injected into all agent pods. Useful for cluster-wide provider config (e.g. OPENAI_BASE_URL, AGENT_PROVIDER).
agentResources.requests.cpu100mCPU request for agent pods.
agentResources.requests.memory256MiMemory request for agent pods.
agentResources.limits.cpu500mCPU limit for agent pods.
agentResources.limits.memory512MiMemory limit for agent pods.

agentExtraEnv example

agentExtraEnv:
  - name: AGENT_PROVIDER
    value: openai
  - name: OPENAI_BASE_URL
    value: http://ollama.ollama.svc.cluster.local:11434/v1
  - name: OPENAI_API_KEY
    value: ollama

Operator pod configuration

ValueDefaultDescription
operatorImageghcr.io/arkonis-dev/ark-operator:latestContainer image for the operator.
operatorImagePullPolicyIfNotPresentImage pull policy for the operator.
resources.requests.cpu100mCPU request for the operator pod.
resources.requests.memory128MiMemory request for the operator pod.
resources.limits.cpu500mCPU limit for the operator pod.
resources.limits.memory256MiMemory limit for the operator pod.

Observability

ValueDefaultDescription
otel.endpoint""OTel collector endpoint. When set, forwarded to the operator and all agent pods as OTEL_EXPORTER_OTLP_ENDPOINT.
otel.serviceNameark-operatorService name reported in traces from the operator. Agent pods use ark-agent.

Image pull secrets

ValueDefaultDescription
imagePullSecrets[]List of image pull secret names for both operator and agent pods.

Example: Ollama installation

helm install ark-operator arkonis/ark-operator \
  --namespace ark-system \
  --create-namespace \
  --set taskQueueURL=redis.ark-system.svc.cluster.local:6379 \
  --set triggerWebhook.url=http://ark-operator.ark-system.svc.cluster.local:8092 \
  --set agentExtraEnv[0].name=AGENT_PROVIDER,agentExtraEnv[0].value=openai \
  --set agentExtraEnv[1].name=OPENAI_BASE_URL,agentExtraEnv[1].value=http://ollama.ollama.svc.cluster.local:11434/v1 \
  --set agentExtraEnv[2].name=OPENAI_API_KEY,agentExtraEnv[2].value=ollama

Example: OpenAI with existing secret

kubectl create secret generic ark-api-keys \
  --from-literal=OPENAI_API_KEY=sk-... \
  --namespace ark-system

helm install ark-operator arkonis/ark-operator \
  --namespace ark-system \
  --create-namespace \
  --set taskQueueURL=redis.ark-system.svc.cluster.local:6379 \
  --set apiKeys.existingSecret=ark-api-keys

See also