We are proud to announce Camunda BPM Run, a new distribution of Camunda BPM that provides the Camunda web applications (Cockpit, Tasklist, Admin) and the REST API.

Camunda BPM Run is highly configurable and can be operated without any Java knowledge.

Run is for you if at least one of the following statements is true:

  • You need a standalone process engine accessible via REST API
  • You don’t have extensive Java knowledge (or none at all) but still want to use Camunda BPM
  • You don’t want to configure an application server yourself
  • You want to configure everything in one place
  • You just want to Run Camunda BPM

Camunda BPM 7.13.0-alpha2 ships the first increment of Run. This blogpost shows:

  • Starting with Run
  • Highlight Features: What is in our first Run release?
  • Outlook: Where do we want to take Run?
  • Changes in Camunda BPM Starter: We moved Camunda BPM Spring Boot Starter into the 7.x release cycle. Here is why.

Starting with Camunda BPM Run

Follow these simple steps to start Run:

  1. Download the distro.
  2. Unpack the downloaded archive
  3. Put a BPMN file in /configuration/resources (optional)
  4. Execute one of the start scripts (start.bat or start.sh)
  5. Point your browser to https://localhost:8080 to access the Camunda webapps (Cockpit, Tasklist, Admin)
  6. Access the REST API via https://localhost:8080/rest/ (e.g., https://localhost:8080/rest/engine)

For more configuration options, head over to the configuration folder, and you will find a file called application.yml. This is the only configuration file you will need to touch.
You can fill it with configuration properties from this list of available properties.

By default, Run starts with a file-based H2 database, which is intended for testing. If you want to use a different database, you can configure it as described in the documentation. Make sure to drop a matching JDBC driver jar in the configuration/database folder.

Here is an overview of an unpacked Camunda BPM Run distro:

├── configuration/
│   ├── database/
│   │   └── put your database driver jar here
│   ├── keystore/
│   │   └── put your SSL keystore here if you want to use HTTPS
│   ├── resources/
│   │   └── put your BPMN files here
│   └── application.yml
├── internal/
├── start.bat
└── start.sh

Highlight Features

Optional Webapps and REST API

You can enable the webapps and the REST API independently by passing the --rest or --webapps argument to the start script. If you pass both arguments or no argument, Camunda BPM Run will start with both webapps and REST API.

Auto-Deployment of Resources

If you already have some models you want to deploy, drop them in the resources folder along with all other deployment resources.
Everything in this folder will be picked up and deployed during engine startup.


Camunda BPM Run supports Cross-Origin Resource Sharing. You can enable it and configure allowed origins via the application.yml configuration file.

  enabled: true
  allowed-origins: https://foo.bar

Outlook on Camunda BPM Run

Camunda BPM Run is still at an early alpha stage but provides already many comfort features in terms of easy configuration and fast bootstrapping of a Camunda BPM engine.
We have many ideas for further improvements to the distro, like providing a docker container, integrate a Swagger API endpoint, or add a drop folder for custom script engines. You can find a list of current and completed tickets related to Camunda BPM Run in our Jira.

Keep in mind that we have not decided on a final set of features yet, and all of them can change or not end up as part of Camunda BPM Run.

Feel free to share your ideas or suggestions in our forum.

Changes in Camunda BPM Spring Boot Starter

Camunda BPM Run is based on Camunda BPM Spring Boot Starter. Until 7.12, the Starter had its own versioning scheme and release cycle (see the version compatibility table for reference). With the introduction of Run, we have made two noteworthy changes:

  1. The Spring Boot starter follows the 7.x release cycle of the core platform. We will release the Spring Boot starter with every new 7.x version (be it a minor, patch, or alpha release).
  2. The Spring Boot starter codebase is located in the core platform repository.

We have made these changes for the following reasons:

  1. Camunda BPM Run follows the 7.x cycle. By releasing the Spring Boot starter in the same cycle, we can develop and release Camunda BPM more efficiently.
  2. The 7.x cycle is the central release cycle of the Camunda BPM product that our userbase follows closely. Aligning Spring Boot starter with that will facilitate choosing the right Spring Boot starter version.
  3. By releasing the Spring Boot starter together with the core platform, we will indirectly improve our product quality. One Spring Boot starter release will be developed, released, and tested for exactly one Camunda BPM version. Problems due to version incompatibilities will become less likely to appear.

The changes apply only from 7.13 onwards. The Spring Boot starter for previous versions is not affected, regarding both versioning and code location (e.g., see https://github.com/camunda/camunda-bpm-spring-boot-starter/tree/3.4).

Camunda Developer Community

Have deeper questions about this release?

  • Header image that reads, "Camunda Automation Platform 7.18.0-alpha4 Released

    Camunda Automation Platform 7.18.0-alpha4 Released

    We are pleased to announce the next alpha release of Camunda Platform Runtime 7.18. This release features the following improvements: Support for H2 2.1 Traditional Chinese translations are available Improved status monitoring of batch jobs Improved safety of executing a batch operation on the Batch Operation page 8 Bug Fixes You can download Camunda for free or run it with Docker. For a complete list of all improvements, take a look at the release notes. Please also see the list of known issues. If you want to dig in deeper, you can find the source code on GitHub. Support for H2 2.1 This release adds support for the H2 database in version 2.1, which provides fixes for vulnerabilities. Enterprise customers...

    Read more
  • A title slide that reads "Camunda Optimize 3.9.0 alpha3 Released

    Camunda Optimize 3.9.0 alpha3 Released

    We’re excited to announce a new release of Camunda Optimize. Camunda Optimize provides business activity monitoring for workflows, supporting continuous process improvement by providing transparency into your automated workflows and decisions. Business-friendly reports, dashboards, and alerts make it possible to identify process bottlenecks, improve end-to-end processes, and evaluate the success of your process automation initiative. In the rest of this post, we’ll highlight some of the new capabilities introduced in Optimize 3.9.0 alpha3. What’s new? Ease of adding new reports to dashboard Reports are added to dashboards to design an individual overview of the performance of your processes. Adding reports to dashboards was already possible with previous versions of Optimize, but now we’ve reduced the number of steps to do...

    Read more
  • A Technical Sneak Peek into Camunda’s Connector...

    Learn what a connector is made of, how the code for a connector roughly looks, and how connectors can be operated in various scenarios. Since this is a preview, details are subject to change.

    Read more

Ready to get started?

Still have questions?