ChromaDB

The ChromaDB Helm chart provides an easy way to deploy ChromaDB, a high-performance embedding database designed for AI applications. This chart allows you to manage ChromaDB instances on Kubernetes with customizable resource allocation, persistence, and scaling options.

Prerequisites

• Kubernetes 1.19+
• Helm 3+

Add Helm Repository

Before deploying the ChromaDB chart, add the Helm repository to your local setup:

helm repo add zopdev https://helm.zop.dev
helm repo update

For more details, refer to the Helm Repository Documentation.

Install Helm Chart

To install the ChromaDB Helm chart, use the following command:

helm install [RELEASE_NAME] zopdev/chromadb

Replace [RELEASE_NAME] with your desired release name. For example:

helm install my-chromadb zopdev/chromadb

To customize configurations, provide a values.yaml file or override values via the command line.

See Helm Install Documentation for more information.

Uninstall Helm Chart

To remove the ChromaDB deployment and all associated Kubernetes resources, use the following command:

helm uninstall [RELEASE_NAME]

For example:

helm uninstall my-chromadb

See Helm Uninstall Documentation for additional details.

Configuration

The ChromaDB Helm chart includes several configuration options to tailor the deployment to your needs. Below is a summary of the key configurations:

You can override these values in a values.yaml file or via the command line during installation.

Example values.yaml File

version: 0.6.3

resources:
  requests:
    memory: "1Gi"
    cpu: "100m"
  limits:
    memory: "2Gi"
    cpu: "1000m"

diskSize: "10Gi"

To use this configuration, save it to a values.yaml file and apply it during installation:

helm install my-chromadb zopdev/chromadb -f values.yaml

Features

• Scalable Architecture: Configure resources and scaling options to optimize performance for embedding-intensive workloads.
• Persistent Storage: Keep ChromaDB data intact across pod restarts with configurable persistent volumes.
• Customizable Resource Allocation: Tailor CPU and memory resources to match workload requirements.
• Easy Deployment: Simplified Helm chart for rapid deployment of ChromaDB in Kubernetes environments.

Pod Scheduling

nodeSelector, tolerations and affinity are passed straight through to the pod spec. All three are empty by default and render nothing, so leaving them unset changes nothing for an existing release.

Together they place the workload on a dedicated node pool — the nodeSelector picks the pool, the toleration gets past its taint:

nodeSelector:
  workload: stateful

tolerations:
  - key: workload
    operator: Equal
    value: stateful
    effect: NoSchedule

affinity takes a full Affinity object and is rendered verbatim.

Contributing

We welcome contributions to improve this Helm chart. Please refer to the CONTRIBUTING.md file for contribution guidelines.

Code of Conduct

To maintain a healthy and collaborative community, please adhere to our Code of Conduct.

License

This project is licensed under the LICENSE. Please review it for terms of use.

Connection Config

• CHROMA_SERVER_HOST : Hostname or service name for the ChromaDB instance.
• CHROMA_SERVER_HTTP_PORT : HTTP port on which ChromaDB listens. Default is 8000 .
• ANONYMIZED_TELEMETRY : Enables/disables sending anonymized telemetry.False means disabled.
• ALLOW_RESET : Allows resetting ChromaDB data if set to true.
• IS_PERSISTENT : Determines if ChromaDB data should be persistent.
• CHROMA_LOG_LEVEL : Log level for ChromaDB .
• CHROMA_DATA_DIR : Directory path where ChromaDB stores its data.
• CHROMA_IMPORT_SETTING : Indicates whether import settings are enabled .