Camunda BPM Run

Camunda BPM Run is a pre-packaged distro of the Camunda BPM platform, including the Camunda webapps (Cockpit, Tasklist, Admin) and the REST API.

The idea behind Run is to provide a full Camunda BPM distro with a simple but powerful configuration mechanism that can be operated by everyone, regardless of their knowledge about Java or application server configuration.

For a step-by-step installation guide head over to the installation section and get started in minutes.

Starting with Camunda BPM Run

After downloading the distro (enterprise) and unpacking it to a folder, you will find the following structure:

camunda-bpm-run
├── configuration/
│   ├── database/
│   │   └── put your database driver jar here
│   ├── keystore/
│   │   └── put your SSL key store here if you want to use HTTPS
│   ├── resources/
│   │   └── put your BPMN files, forms and scripts here
│   └── application.yml
├── internal/
├── start.bat
└── start.sh

Execute one of the two start scripts (start.bat for Windows, start.sh for Linux/Mac). After a few seconds, you will be able to access the Camunda webapps via http://localhost:8080 and the REST API via http://localhost:8080/rest/

Disable Webapps or REST API

By default Camunda BPM Run launches with the webapps and REST API modules. If you want only one of them enabled, execute the start script with a command-line interface with a --webapps or --rest property to enable the specific module.

Connect to a Database

Camunda BPM Run is pre-configured to use a file-based h2 database for testing. If you want to use a custom standalone database, follow these steps:

  1. Make sure your database is among the supported database systems.
  2. Drop a JDBC driver jar for your database system in the configuration/database folder.
  3. Add the JDBC URL and login credentials to the application.yml like described below.
  4. Restart Camunda BPM Run

Deploy BPMN Models

In the unpacked distro, you will find a resources folder. All files (including BPMN, DMN, CMMN, form, and script files) will be deployed when you start Camunda BPM Run.

Deployments via the REST API are still possible.

Automatic License Pickup

If you downloaded the enterprise version of Camunda BPM Run, you will need a license key to enable the enterprise features.

Provided a valid license file under ${user.home}/.camunda/license.txt, Camunda BPM Run will automatically pick it up and use it to unlock the enterprise features.

You can also still enter the license key in the Admin webapp UI.

Configure Camunda BPM Run

Just like all the other distros, you can tailor Camunda BPM Run to your needs. To do this, you only have to edit the application.yml file that you can find in the configuration folder.

Note:

Camunda BPM Run is based on the Camunda Spring Boot Starter. All configuration properties from the camunda-spring-boot-starter are available to customize Camunda BPM Run.

Database

The distro comes with a file-based h2 database for testing. It is recommended to connect to a standalone database system for use in production.

Prefix Property name Description Default value
spring.datasource .url The jdbc URL for the database. -
.driver-class-name The class name of the JDBC driver for your database system. Remember to put the driver jar for your database system in configuration/database. -
.username The username for the database connection. -
.password The password for the database connection. -

Authentication

To add authentication to requests against the REST API, you can enable basic authentication.

Prefix Property name Description Default value
camunda.bpm.run.auth .enabled Switch to enable basic authentication for requests to the REST API. false
.authentication Authentication method, currently only basic is supported. basic

Cross-Origin Resource Sharing

If you want to allow cross-origin requests to the REST API, you need to enable CORS.

Prefix Property name Description Default value
camunda.bpm.run.cors .enabled Switch to enable CORS. false
.allowed-origins Origins that are allowed to make CORS requests. Multiple origins can be separated with commas. * (all origins)

LDAP Identity Service

Camunda BPM can manage users and authorizations on its own, but if you want to use an existing LDAP authentication database you can enable the LDAP Identity Service Plugin which provides read-only access to the LDAP repository.

Find all available configuration properties in the LDAP Plugin Guide

Prefix Property name Description Default value
camunda.bpm.run.ldap .enabled Switch to enable the LDAP identity service plugin. false

HTTPS

Camunda BPM Run supports HTTPS over SSL. To enable it, you will need a valid SSL certificate signed by a trusted provider and stored in a key store file (either .jks or .p12). For testing, we included a self-signed certificate. You should not use this in production. To enable it, add the following properties to your application.yml.

server:
  ssl:
    key-store: classpath:keystore.p12
    key-store-password: camunda
    key-store-type: pkcs12
    key-alias: camunda
    key-password: camunda
  port: 8443

After starting Camunda BPM Run, you can access the webapps via https://localhost:8443 and the REST API via https://localhost:8443/rest.

Prefix Property name Description Default value
server.ssl .key-store Name of the key store file that holds the SSL certificate. This file must be placed in the configuration/keystore folder and has to be either a .jks or a .p12 file. -
.key-store-password Password to access the key store. -
.key-store-type Type of the key store. Can either be jks or p12 -
.key-alias Name that identifies the SSL certificate in the key store. -
.key-password Password to access the SSL certificate in the key store. -

Logging

Camunda BPM provides fine-grained and customizable logging. An overview of the available logging categories can be found in the Logging User Guide. To configure the logging behavior in Camunda BPM Run, customize your application.yml with the following properties.

For more information on logging configuration visit the Spring Boot Logging Guide.

Prefix Property name Description Default value
logging .level.root Set a logging level for all available logging categories. Value can be one of the following: OFF. ERROR. WARN. INFO. DEBUG. ALL -
.level.{logger-name} Set a logging level for a specific logging category. Find an overview over the available categories in the Logging User Guide. Value can be one of the following: OFF. ERROR. WARN. INFO. DEBUG. ALL -
.file Specify a log file location. (e.g. logs/camunda-bpm-run-log.txt) -

On this Page: