Skip to main content
Version: 1.1

Tutorial setup

Welcome to the Getting Started tutorial for Zeebe and Operate.

In this tutorial, we'll walk you through how to:

  • Model a process using Camunda Modeler
  • Deploy the process to Zeebe
  • Create process instances
  • Use workers to complete jobs created by those process instances
  • Correlate messages to process instances
  • Monitor what's happening and get detail about running process instances in Operate

If this is your first time working with Zeebe, we expect this entire guide to take you 30-45 minutes to complete.

If you're looking for a very fast (but less comprehensive) "first contact" experience, you might prefer the Quickstart.

The tutorial assumes you have some basic knowledge of what Zeebe is and what it's used for. If you're completely new to Zeebe, you might find it helpful to read through the "What is Camunda Cloud?" docs article first.

Below are the components you'll use in the tutorial. The easiest way to run them is to download Camunda Modeler and use the operate docker-compose profile in the zeebe-docker-compose repository. Further instructions for using Zeebe with Docker can be found in the README.md file in that repository.

You can also download the full distributions for these components, instead of running them with Docker.

  1. Camunda Modeler: A desktop modeling tool that we'll use to create and configure our process before we deploy it to Zeebe.
  2. 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, which we'll use throughout the tutorial. Please use Zeebe 0.20.0.
  3. Camunda Operate: An operations tool for monitoring and troubleshooting live process instances in Zeebe. Operate is currently available for free and unrestricted non-production use.
  4. Elasticsearch 6.8.0: 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 tutorial. Operate and Zeebe are compatible with Elasticsearch 6.8.0.

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

If you're using the finished model we provide rather than building your own, you can also move ahead to section 3.3: Deploy a Process.

And if you have questions or feedback about the tutorial, we encourage you to visit the Camunda Cloud user forum and ask a question.

There's a "Getting Started" category for topics that you can use when you ask your question or give feedback.