The Altinity Kubernetes Operator for ClickHouse

Running ClickHouse on Kubernetes

Running ClickHouse on Kubernetes is easy with the open-source Altinity Kubernetes operator. This documentation will get you up and running as quickly as possible.

We’ll focus on the basics here: Using the operator to install, configure, and run a ClickHouse cluster in a Kubernetes cluster, including things like Zookeeper that ClickHouse needs. Be aware that the GitHub repo for the project has in-depth technical details on a number of advanced topics when you’re ready to go beyond what we’ll do here.

We’ll also be careful with the word “cluster.” When you have everything up and running, you’ll have a ClickHouse cluster running inside a Kubernetes cluster. Most of the time it’ll be obvious what the word “cluster” refers to, but if there’s any chance it’s not clear, we’ll say “ClickHouse cluster” or “Kubernetes cluster.”

As of this time, the current version of the Altinity Kubernetes Operator is 0.23.5. You can always find the latest released version on the project’s releases page. The operator is released under the Apache 2.0 license.


Altinity Kubernetes Operator Quick Start Guide

Become familiar with the Altinity Kubernetes Operator in the fewest steps.

Kubernetes Install Guide

How to install Kubernetes in different environments

Operator Guide

Installation and Management of clickhouse-operator for Kubernetes