Skip to content

Secure, Fast, and Extensible Sandbox runtime for AI agents.

5.0 KB
Raw Blame
# Copyright 2026 The OpenSandbox Authors
# Default values for opensandbox-server.

# -- Override the name of the chart
nameOverride: ""
# -- Resource names and app.kubernetes.io/name are fixed to this value, independent of release name
fullnameOverride: "opensandbox-server"

# -- Override the namespace (default: opensandbox-system)
namespaceOverride: ""

# -- Image pull secrets for the server deployment. Each entry: {name: <secret-name>}.
imagePullSecrets: []

# Server configuration
server:
  # -- Additional environment variables for the server container.
  env: []
  # - name: OPENSANDBOX_SERVER_API_KEY
  #   valueFrom:
  #     secretKeyRef:
  #       name: opensandbox-api-key
  #       key: api-key

  # -- Server image configuration
  image:
    # -- Server image repository.
    repository: sandbox-registry.cn-zhangjiakou.cr.aliyuncs.com/opensandbox/server
    # -- Server image pull policy.
    pullPolicy: IfNotPresent
    # -- Server image tag. Empty uses the release-<appVersion> image tag
    # published for this chart version.
    tag: ""

  # -- Number of server replicas. Keep one active server; multi-replica HA is not supported yet.
  replicaCount: 1

  # -- Resource requests and limits
  resources:
    limits:
      cpu: "2"
      memory: 8Gi
    requests:
      cpu: "1"
      memory: 4Gi

  service:
    # -- Service type for the server. Set to NodePort or LoadBalancer to reach the server from outside the cluster.
    type: ClusterIP
    # -- Node port to bind when type is not ClusterIP. Empty lets Kubernetes allocate one from the cluster node-port range.
    nodePort: ""

  # -- Tolerations for the server pod.
  tolerations: []
  # -- Affinity for the server pod.
  affinity: {}
  # -- Additional volume mounts for the server container.
  volumeMounts: []
  # -- Additional volumes for the server pod.
  volumes: []
  # -- Node selector for the server pod.
  nodeSelector: {}
  # -- Pod-level security context for the server pod.
  podSecurityContext: {}
  # -- Container-level security context for the server container.
  containerSecurityContext: {}
  # -- Extra annotations for the server pod.
  podAnnotations: {}
  # -- Extra labels for the server pod.
  podLabels: {}
  # -- Priority class name for the server pod.
  priorityClassName: ""
  # -- Topology spread constraints for the server pod.
  topologySpreadConstraints: []

  # Ingress gateway announcement (components/ingress runs in its own
  # ingress-gateway chart). When enabled, writes config [ingress] mode = "gateway"
  # and wires secure-access env, so the server returns the gateway address to clients.
  gateway:
    # -- Whether the server announces an ingress gateway (config [ingress] mode = "gateway").
    enabled: false
    # -- Gateway host/address returned to clients when the gateway is enabled.
    host: opensandbox.example.com
    # -- Gateway route mode: header or uri. Must match gateway.gatewayRouteMode
    # in the ingress-gateway chart.
    gatewayRouteMode: "header"
    # OSEP-0011 signing keys shared between server and ingress.
    # When keys are provided, the server signs route tokens with the active key
    # and the ingress gateway verifies them.
    secureAccess:
      # -- Active signing key id, one character in [0-9a-z].
      activeKey: ""
      # -- List of signing keys. Each entry: { key_id: "a", key: "<base64-secret>" }.
      # key_id must be exactly one character in [0-9a-z].
      keys: []
      # -- Name of an existing Secret holding the signing keys (keys + active-key),
      # as an alternative to plaintext `keys` above (mutually exclusive).
      # The Secret must carry two entries:
      #   keys:       the key ring, "a=<base64-secret>[,b=<base64-secret>...]"
      #   active-key: the active signing key id, one character in [0-9a-z]
      # The chart wires it into the server as environment variables
      # (OPENSANDBOX_SECURE_ACCESS_*), so key material never appears in values,
      # the server ConfigMap, or pod args. The ingress-gateway chart consumes the
      # same Secret for verification.
      # Env-sourced Secrets are read once at container start: after updating
      # the Secret in place, `kubectl rollout restart` the server Deployment
      # (or version the Secret name to get a spec-driven rollout).
      existingSecret: ""

# -- Server config (TOML). Mounted at /etc/opensandbox/config.toml.
# [kubernetes].namespace below is the sandbox workload namespace: the chart
# does not create it, so create it before submitting workloads (see README).
configToml: |
  [server]
  host = "0.0.0.0"
  port = 80
  api_key = ""

  [log]
  level = "INFO"

  [runtime]
  type = "kubernetes"
  execd_image = "sandbox-registry.cn-zhangjiakou.cr.aliyuncs.com/opensandbox/execd:release-1.2.0"

  [kubernetes]
  kubeconfig_path = ""
  namespace = "opensandbox"
  informer_resync_seconds = 300
  informer_watch_timeout_seconds = 60
  workload_provider = "batchsandbox"
  batchsandbox_template_file = "/etc/opensandbox/example.batchsandbox-template.yaml"

  [egress]
  image = "sandbox-registry.cn-zhangjiakou.cr.aliyuncs.com/opensandbox/egress:release-1.2.0"
  mode = "dns+nft"