Deploy a process definition

Creating and Deploying a Simple BPMN Process with Camunda Modeler

This documentation will guide you through the process of creating a simple BPMN (Business Process Model and Notation) diagram containing a start event, user task, and end event using Camunda Modeler. You will also learn how to deploy the BPMN process to the Camunda engine for execution.

Step 1: Prerequisites

Before you start, ensure you have installed the Resources and Downloads.

Step 2: Example process modeling

  1. You should see a blank canvas where you can start designing your BPMN diagram. (BPMN Platform 7)

  2. Drag and drop the Start Event element from the toolbar onto the canvas. You can find it under the "Events" section.

  3. Drag and drop the User Task element from the toolbar onto the canvas. You can find it under the "Tasks" section.

  4. Drag and drop the End Event element from the toolbar onto the canvas. You can find it under the "Events" section.

  5. Connect the Start Event to the User Task by dragging and dropping a sequence flow connector from the toolbar. Then connect the User Task to the End Event with another sequence flow.

  6. Double-click on the User Task shape to open its properties panel.

  7. In the properties panel, specify the task’s name and other relevant details. You can set attributes like task name, task ID, assignee, candidate groups, etc., based on your requirements.

  8. Optionally, you can add additional elements like gateways or other tasks to the process to define more complex flows.

  9. Set "History lifetime" of the process respective to your needs

    camunda process set history ttl

  10. Save your BPMN diagram with a descriptive name and the .bpmn extension.

Step 3: Switch Camunda Modeler to compatible version

  1. In the OMN Configuration client or in user settings you can check the installed version of OMN and the connected Camunda engine.

  2. Set your Camunda Modeler installation to the used Camunda version of your OMN installation

    camunda deployment set version

Step 4: Deploy the BPMN Diagram to Camunda Engine

  1. Click on the "Deploy" button located in the toolbar. This will open the Deployment dialog.

  2. In the Deployment dialog, provide the necessary details such as Deployment Name, Source, and Tenant ID (if applicable).

  3. Select the BPMN diagram you want to deploy by clicking on the "+" button next to "Add Diagrams." Browse your file system and select the previously saved BPMN diagram file.

  4. Ensure that the deployment options, such as "Deploy Changed Only" or "Resume Previous Versions," are set according to your needs.

  5. The deployment URL is

    1. http://<hostname>:8080/engine-rest

    2. depending on your version, it can be taken from the OMN Configuration client.

  6. Click the "Deploy" button to initiate the deployment process.

  7. Once the deployment is successful, you can access and execute the deployed process in the Camunda engine.

Welcome to the AI Chat!

Write a prompt to get started...