This is a prerelease version.

View latest

Deploying on Kubernetes

Discover ways to deploy Hazelcast clusters in Kubernetes (K8s) environments.

For production-grade Kubernetes deployments, we recommend you use Hazelcast Platform Operator.


  • Hazelcast Platform Operator

  • Helm

  • Kubectl

helm repo add hazelcast
helm repo update
helm install operator hazelcast/hazelcast-platform-operator --set installCRDs=true
cat << EOF | kubectl apply -f -
kind: Hazelcast
  name: hazelcast
helm repo add hazelcast
helm repo update
helm install hazelcast hazelcast/hazelcast
kubectl apply -f

kubectl run hazelcast-0 --image=hazelcast/hazelcast:{full-version} -l "role=hazelcast"
kubectl run hazelcast-1 --image=hazelcast/hazelcast:{full-version} -l "role=hazelcast"
kubectl run hazelcast-2 --image=hazelcast/hazelcast:{full-version} -l "role=hazelcast"

kubectl create service clusterip hz-hazelcast --tcp=5701 -o yaml --dry-run=client | kubectl set selector --local -f - "role=hazelcast" -o yaml | kubectl create -f -

Hazelcast Platform Operator for Kubernetes/OpenShift

Kubernetes Operators are software extensions to Kubernetes which help you create and manage your applications. Hazelcast Platform Operator automates common management tasks such as configuring, creating, and scaling Hazelcast clusters on Kubernetes and Red Hat OpenShift. By taking care of manual deployment and life-cycle management, Hazelcast Platform Operator makes it simpler to work with Hazelcast clusters.

See the Hazelcast Platform Operator Documentation for more information and find details about deploying a Hazelcast cluster in Kubernetes and also connecting clients outside Kubernetes.

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.