Skip to main content

Camunda 8 on Kubernetes

We strongly recommend using Kubernetes and Helm to deploy and run Camunda 8 in production.

There are many ways you can provision and configure a Kubernetes cluster, and there are a number of architectural choices you need to make. Will your workers run in the Kubernetes cluster or external to it? You will need to configure your Kubernetes cluster and modify this to suit the architecture you are building.

Kubernetes environments​

You can install Camunda 8 on your Kubernetes environment of choice, e.g.:

Officially supported platforms​

With the right configuration, Camunda 8 can be deployed on any Kubernetes distribution (Cloud or on-premises). However, we officially test and support a specific list of platforms.

Versioning​

Starting from July 2023 (v8.2.8), the Camunda 8 Helm chart version follows the same unified schema and schedule as Camunda 8 applications (e.g., if the application version is 8.2.8, then chart version is also 8.2.8).

For more details about the applications version included in the Helm chart, review the full version matrix.

Use Helm to install on Kubernetes​

There are several alternatives to deploy applications to a Kubernetes cluster, but we recommend using our provided Helm charts to deploy a set of components into your cluster. Helm allows you to choose exactly what chart (set of components) you want to install and how these components need to be configured.

At helm.camunda.io, you'll find a Helm chart to configure a three-broker cluster with two Elasticsearch instances, Operate, two Zeebe Gateways and Tasklist. This size is comparable with the Production-S cluster plan in Camunda 8 SaaS. It should be sufficient for 80% of use cases.

Refer to the documentation on Camunda's Helm charts for details.

To do, you must have the following tools installed in your local environment:

  • kubectl: Kubernetes Control CLI tool, installed and connected to your cluster
  • helm: Kubernetes Helm CLI tool
  • Camunda Desktop Modeler: to model/modify business processes. Learn more.
  • Zeebe CTL (zbctl): command line tool to interact with a Zeebe cluster (local/remote). You can get the zbctl tool from the official Zeebe release page.