# 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

```bash
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`:

```yaml
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:

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

## Resource Limits

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

## Prometheus Monitoring

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

## ServiceAccount for Cloud IAM

### AWS IRSA (EKS)

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

See [AWS IRSA](/docs/enterprise/deployment/irsa.md) for full setup instructions.

### GKE Workload Identity

```yaml
serviceAccount:
  create: true
  annotations:
    iam.gke.io/gcp-service-account: my-gcp-sa@my-project.iam.gserviceaccount.com
```

### Azure Workload Identity (AKS)

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.spice.ai/docs/enterprise/deployment/helm-chart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.