Skip to main content

Deployment guide

This chapter contains information for users who want to deploy and run Zeebe in a private cloud or on their own hardware.

Zeebe can be run as a Docker image or as a Kubernetes deployment.

We recommend using Docker during development. This gives you a consistent, repeatable development environment.

We recommend using either Camunda Cloud or Kubernetes and container images in production. This provides you with predictable and consistent configuration, and the ability to manage deployment using automation tools.

The deployment guide covers the following topics:

  • Local installation - Contains instructions and a quick start guide to install Zeebe locally.
  • Docker container - Covers running Zeebe in a Docker environment.
  • Kubernetes deployment - Gives information on running Zeebe in a Kubernetes environment.
  • Configuration - Explains the configuration options. These configuration options apply to both environments, but not to Camunda Cloud. In Camunda Cloud, the configuration is provided for you.
  • Security - Discusses the security aspects of running Zeebe and how to use them.
  • Operation - Outlines topics that become relevant when you want to operate Zeebe in production.

This deployment guide also integrates with the following:

  1. Zeebe Distribution: The Zeebe distribution contains the workflow engine where we'll deploy our process model; the engine is also responsible for managing the state of active process instances. Included in the distro is the Zeebe CLI. Refer to our installation guide.
  2. Elasticsearch 7.x: An open-source distributed datastore that can connect to Zeebe to store process data for auditing, visualization, analysis, etc. Camunda Operate uses Elasticsearch as its underlying datastore, which is why you need to download Elasticsearch to complete this deployment. Currently, 7.x is the minimum mandatory version with Zeebe 1.x. With version 0.20.0 (currently used in our tutorial,) you may use 6.x.

New to BPMN and want to learn more before moving forward? This blog post helps explain the standard and why it's a good fit for microservices orchestration.

If you're already familiar with BPMN and how to create a BPMN model in Camunda Modeler, you can find the finished model we create during the tutorial here: Zeebe Getting Started Tutorial Process Model.

Additional resources

If you have questions or feedback about deployment with Zeebe, we encourage you to visit the following:

Additional client configurations

Zeebe's Java and Go clients each have getting started guides of their own, showing in much greater detail how you can use the clients in the worker services you orchestrate with Zeebe.

Beyond Java and Go, it's possible to create clients for Zeebe in a range of other programming languages, including JavaScript and C#, via community-supported libraries. The Awesome Zeebe page includes community-contributed clients in other languages, and this blog post walks through how to generate a new client stub for Zeebe using gRPC.