This is a prerelease version.

View latest

Deploying on Kubernetes

Discover ways to deploy Hazelcast clusters in Kubernetes environments.


Hazelcast CP Subsystem can be used safely in Kubernetes only if CP Subsystem Persistence is enabled (Enterprise Feature). Otherwise, a CP Subsystem Group may not recover after scaling the cluster or a rolling upgrade.


If you just want to play with Hazelcast on Kubernetes, execute the following commands to create a Hazelcast cluster with 3 members in the default namespace using the default Service Account.

kubectl apply -f
kubectl run hazelcast-1 --image=hazelcast/hazelcast:5.1-SNAPSHOT
kubectl run hazelcast-2 --image=hazelcast/hazelcast:5.1-SNAPSHOT
kubectl run hazelcast-3 --image=hazelcast/hazelcast:5.1-SNAPSHOT

Hazelcast members automatically discover themselves and form one Hazelcast cluster.

For production-grade Kubernetes deployment, use Helm chart or Kubernetes/OpenShift Operator.

Helm Chart

Helm is a package manager for Kubernetes. Hazelcast is distributed in a form of Helm Charts:

See the Hazelcast Helm Charts documentation for more details.

Helm-based Kubernetes/OpenShift Operators

Kubernetes Operators are software extensions to Kubernetes which help you create and manage your applications. You can deploy and manage Hazelcast using the following Helm-based Operators:

There are a few different ways in using Hazelcast Operators:

Since all the Operators mentioned above are generated from Helm Charts, their functionality and input parameters are exactly the same as in the case of Helm Charts.

Enterprise Operator (Preview)

Hazelcast Enterprise Operator is currently in the early alpha preview stage, but it will soon become the preferred way of installing Hazelcast in Kubernetes/OpenShift environments. For a tutorial, see Deploy a Cluster with the Enterprise Operator (Preview).