Install the ClickHouse Operator with Helm

This guide covers installing the ClickHouse Operator using Helm charts.

Prerequisites

Kubernetes cluster v1.28.0 or later
Helm v3.0 or later
kubectl configured to communicate with your cluster

Install Helm

If you don’t have Helm installed:

curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

Verify installation:

helm version

Install the Operator

helm install cert-manager oci://quay.io/jetstack/charts/cert-manager -n cert-manager --create-namespace --set crds.enabled=true

From OCI Helm repository

Install the latest release

    helm install clickhouse-operator oci://ghcr.io/clickhouse/clickhouse-operator-helm \
       --create-namespace \
       -n clickhouse-operator-system

Install a specific operator version

    helm install clickhouse-operator oci://ghcr.io/clickhouse/clickhouse-operator-helm \
       --create-namespace \
       -n clickhouse-operator-system \
       --set manager.image.tag=<operator version>

From Local Chart

Clone the repository and install from the local chart:

git clone https://github.com/ClickHouse/clickhouse-operator.git
cd clickhouse-operator
helm install clickhouse-operator ./dist/chart

Configuration options

For advanced configuration options, refer to the values.yaml file in the Helm chart