Local installation with Camunda 8 Run
Camunda 8 Run is not supported for production use.
The Camunda 8 Run script allows you to install and start a simplified, single-application Camunda configuration in a local development environment. This page guides you through using Camunda 8 Run on a local or virtual machine.
Camunda 8 Run includes the following:
- Zeebe
- Operate
- Tasklist
- Connectors
- Elasticsearch
Prerequisites
- OpenJDK 21+
- Desktop Modeler
After installing OpenJDK, ensure JAVA_HOME
is set by running java -version
in a new terminal.
If no version of Java is found, follow your chosen installation's instructions for setting JAVA_HOME
before continuing.
Install and start Camunda 8 Run
- Download the latest release of Camunda 8 Run for your operating system and architecture. Opening the .tgz file extracts the Camunda 8 Run script into a new directory.
- Navigate to the new
c8run
directory. - Start Camunda 8 Run by running
./start.sh
(or.\c8run.exe start
on Windows) in your terminal.
When successful, a new Operate window automatically opens.
If Camunda 8 Run fails to start, run the shutdown script to end the current processes, then run the start script again.
Configuration options
The following command line arguments are available:
Argument | Description |
---|---|
--config | Applies the specified Zeebe application.yaml . Not available on Windows. |
--detached | Starts Camunda 8 Run as a detached process. The process is detached by default on Windows. |
Access Camunda components
All Camunda 8 Run components can be accessed using the username/password combination demo
/demo
.
Tasklist and Operate are available at:
- Tasklist: http://localhost:8080/tasklist
- Operate: http://localhost:8080/operate
The following components do not have a web interface, but the URLs may be required for additional configuration:
- Zeebe Gateway: http://localhost:26500
- Connectors: http://localhost:8085
The Connectors URL displays a login page, but cannot be logged into.
Deploy diagrams from Desktop Modeler
Make sure you have installed Desktop Modeler before continuing.
To deploy diagrams from Desktop Modeler, the following configuration is required:
- Target: Self-Managed
- Cluster endpoint:
http://localhost:26500
, the location of your Zeebe Gateway - Authentication: None
A success notification displays when complete. Start a new process instance to view your running process in Operate.
Use built-in and custom Connectors
Desktop Modeler automatically fetches templates for pre-built Connectors. Custom Connectors can also be added to your Camunda 8 Run distribution.
To add a custom Connector:
- Place the Connector's .jar file in the
/custom_connectors
folder contained in the/c8run
directory. - Place the element template in the appropriate folder for your installation. See Search Paths for more information.
Once configured correctly, your Connectors are available for use in Modeler.
Use Camunda APIs
Camunda 8 Run authenticates with the Tasklist, Operate, and Zeebe APIs, as well as the unified Camunda 8 REST API, by including cookie headers in each request. This cookie can be obtained by using the API endpoint /api/login
.
To authenticate and begin making requests, take the following steps:
- Tasklist, Operate, and Zeebe
- Camunda 8 REST API
- Log in as user 'demo' and store the cookie in the file
cookie.txt
:
curl --request POST 'http://localhost:8080/api/login?username=demo&password=demo' \
--cookie-jar cookie.txt
- Send the cookie (as a header) in each API request. In this case, request all process definitions:
curl --request POST 'http://localhost:8080/v1/process-definitions/search' \
--cookie cookie.txt \
--header 'Content-Type: application/json' \
--data-raw '{}'
Some endpoints in the Camunda 8 REST API are considered alpha features, and are still in development.
- Log in as user 'demo' and store the cookie in the file
cookie.txt
:
curl --request POST 'http://localhost:8080/api/login?username=demo&password=demo' \
--cookie-jar cookie.txt
- Send the cookie (as a header) in each API request. In this case, the topology of your Zeebe cluster:
curl --cookie cookie.txt localhost:8080/v2/topology
Shut down Camunda 8 Run
To shut down Camunda 8 Run and end all running processes, run ./shutdown.sh
(or .\c8run.exe stop
on Windows) from the C8Run directory.