Install and start Camunda 8 Run
Use this page to install Camunda 8 Run locally, start it on macOS, Linux, or Windows, and shut it down cleanly.
Prerequisites
- OpenJDK 21–25: Required for running Camunda 8 as a Java application.
- Desktop Modeler
- If using Ubuntu: Ubuntu 22.04 or newer
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
.tgzfile extracts the Camunda 8 Run script into a new directory. - Navigate to the new
c8rundirectory. - Start Camunda 8 Run by following the steps below, depending on your operating system.
- Mac OS + Linux
- Windows
Run the helper script:
./start.sh
Or use the CLI command:
./c8run start
Use the CLI command:
.\c8run.exe start
If startup is successful, a browser window for Operate will open automatically. Alternatively, you can access Operate at http://localhost:8080/operate.
If Camunda 8 Run fails to start, run the shutdown script to end the current processes, then run the start script again.
For container-based local deployments, see the developer quickstart with Docker Compose.
For CLI flags and permanent configuration, see configure Camunda 8 Run.
Shut down Camunda 8 Run
To shut down Camunda 8 Run and end all running processes, run the following command from the c8run directory:
- Mac OS + Linux
- Windows
./shutdown.sh
.\c8run.exe stop
For Docker Compose environments, use the stop commands in the developer quickstart with Docker Compose.
Next steps
- Review configure Camunda 8 Run.
- Review configure secondary storage in Camunda 8 Run.
- Identify and resolve common issues when starting, configuring, or using Camunda 8 Run.