Skip to main content
Version: 8.9 (unreleased)

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
note

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

  1. 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.
  2. Navigate to the new c8run directory.
  3. Start Camunda 8 Run by following the steps below, depending on your operating system.

Run the helper script:

./start.sh

Or use the CLI command:

./c8run start

If startup is successful, a browser window for Operate will open automatically. Alternatively, you can access Operate at http://localhost:8080/operate.

note

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:

./shutdown.sh

For Docker Compose environments, use the stop commands in the developer quickstart with Docker Compose.

Next steps