Helm Installation

All Tiers

Calabi ships as a single Helm chart that deploys all enabled modules. One install per tenant.

Prerequisites

• Kubernetes 1.28+ cluster
• Helm 3.16+
• A relational database instance accessible from the cluster
• A search engine cluster accessible from the cluster
• AWS Secrets Manager (for credential storage)
• Istio service mesh installed (or configure ingressController: gateway)

Add Helm Repository

helm repo add calabi https://helm.calabi.ai
helm repo update

Minimal Starter Install

helm install calabi calabi/calabi \
  -f values.starter.yaml \
  --set global.tenant=acme-corp \
  --set global.domain=calabi.acme-corp.com \
  --set global.postgres.host=pg.acme-corp.internal \
  --set global.search.host=os.acme-corp.internal \
  --namespace calabi-acme-corp \
  --create-namespace

Professional Install

helm install calabi calabi/calabi \
  -f values.professional.yaml \
  -f clients/acme-corp/values.yaml \
  --set global.tenant=acme-corp \
  --set calabiConnect.airbyteWorkspaceId=<uuid> \
  --namespace calabi-acme-corp \
  --create-namespace

Values Hierarchy

values.yaml                    ← base defaults
  └── values.{tier}.yaml       ← tier preset (starter / professional / enterprise)
        └── clients/{tenant}/values.yaml  ← tenant-specific overrides

Required values per tenant

Value	Required	Example
global.tenant	YES	acme-corp
global.domain	YES	calabi.acme-corp.com
global.licenseTier	YES	professional
global.postgres.host	YES	pg.acme-corp.internal
global.search.host	YES	os.acme-corp.internal
calabiConnect.airbyteWorkspaceId	Prof+	uuid-v4-here
calabiAgent.env.AZURE_OPENAI_ENDPOINT	YES	https://xxx.openai.azure.com/
calabi.catalogue.authorizer.adminPrincipals	YES	["admin@acme-corp.com"]

Verify Installation

# Check all pods are Running
kubectl get pods -n calabi-acme-corp

# Check services
kubectl get svc -n calabi-acme-corp

# Check VirtualServices (Istio)
kubectl get vs -n calabi-acme-corp

Upgrade

helm upgrade calabi calabi/calabi \
  -f values.professional.yaml \
  -f clients/acme-corp/values.yaml \
  --namespace calabi-acme-corp

Uninstall

helm uninstall calabi --namespace calabi-acme-corp
# Note: does NOT delete PVCs or databases — manual cleanup required