Helm Chart

Deploy Spice.ai Enterprise on Kubernetes with the official Helm chart.

The Spice.ai Enterprise Helm chart deploys the Spice runtime as a Kubernetes Deployment or StatefulSet with a ConfigMap-mounted Spicepod configuration.

Install

helm install spiceai deploy/chart \
  --set spicepod.name=my-app

Values Reference

Parameter	Description	Default
image.repository	Container image repository	709825985650.dkr.ecr.us-east-1.amazonaws.com/spice-ai/spiceai-enterprise-byol
image.tag	Container image tag	latest-models
replicaCount	Number of replicas	1
serviceAccount.create	Create a ServiceAccount	false
serviceAccount.name	ServiceAccount name	—
serviceAccount.annotations	Annotations for the ServiceAccount	{}
service.type	Kubernetes Service type	—
service.additionalAnnotations	Annotations for the Service	{}
stateful.enabled	Use a StatefulSet with PVC	false
stateful.storageClass	StorageClass for StatefulSet PVC	standard
stateful.size	PVC size	1Gi
stateful.mountPath	Mount path in container	/data
monitoring.podMonitor.enabled	Create a PodMonitor for Prometheus	false
monitoring.podMonitor.additionalLabels	Labels for the PodMonitor	{}
additionalLabels	Labels added to all resources	{}
additionalEnv	Extra environment variables	[]
resources	CPU/memory requests and limits	{}
volumes	Additional volumes	[]
volumeMounts	Additional volume mounts	[]
spicepod	Spicepod configuration (inlined into ConfigMap)	—

Spicepod Configuration

The Spicepod spec is inlined directly in the Helm values and mounted as a ConfigMap:

spicepod:
  name: my-app
  version: v1
  kind: Spicepod
  datasets:
    - from: s3://my-bucket/data/
      name: my_data
      params:
        file_format: parquet
      acceleration:
        enabled: true
        engine: duckdb

StatefulSet with Persistent Storage

Enable a StatefulSet with a PersistentVolumeClaim for durable storage:

stateful:
  enabled: true
  storageClass: gp3
  size: 50Gi
  mountPath: /data

Resource Limits

resources:
  requests:
    cpu: 200m
    memory: 1Gi
  limits:
    cpu: "2"
    memory: 4Gi

Prometheus Monitoring

monitoring:
  podMonitor:
    enabled: true
    additionalLabels:
      release: prometheus

ServiceAccount for Cloud IAM

AWS IRSA (EKS)

serviceAccount:
  create: true
  name: spiceai
  annotations:
    eks.amazonaws.com/role-arn: arn:aws:iam::123456789012:role/my-spice-role

See AWS IRSA for full setup instructions.

GKE Workload Identity

serviceAccount:
  create: true
  annotations:
    iam.gke.io/gcp-service-account: [email protected]

Azure Workload Identity (AKS)

serviceAccount:
  create: true
  annotations:
    azure.workload.identity/client-id: <AZURE_CLIENT_ID>