Skip to main content
Version: 8.8

Upgrade to Camunda 8.8

Upgrade your Camunda 8 Self-Managed deployment from version 8.7 to 8.8.

Get started by preparing your Self-Managed environment for upgrade to Camunda 8.8. Confirm upgrade eligibility, understand platform-level changes, and identify actions you might need to take before upgrading.

Prepare for upgrade
Upgrade your Camunda 8 Self-Managed deployment from version 8.7 to 8.8

About​

This guide applies to Camunda 8 Self-Managed installations only and does not apply to Camunda 8 SaaS.

version 8.7 required

Camunda 8 upgrades must be performed sequentially. If your deployment is running a version earlier than 8.7, you must complete the required version-specific upgrades listed in upgrading from an earlier version before you can upgrade to 8.8.

Prepare for upgrade​

Review required preparation steps and important changes before upgrading to Camunda 8.8.

Prepare for upgrade

Upgrade guides​

Choose the upgrade guide that matches how your environment is deployed:

Kubernetes with Helm icon

Kubernetes with Helm

Upgrade a Helm-managed Camunda 8.7 deployment on Kubernetes to version 8.8.

Manual icon

Manual

Manually upgrade a local Camunda installation from an archive distribution to version 8.8.

Dual-region Helm deployments

If you are upgrading a dual-region Helm deployment, follow the standard Helm upgrade guide and then complete the additional dual-region steps.

Camunda 8.7 to 8.8 Dual-Region Upgrade

Docker Compose deployments​

Docker Compose is supported for development and testing environments only.

Camunda does not provide an automated upgrade process for Docker Compose deployments. To upgrade, manually update each component by following the component upgrade guide:

Component upgrade from 8.7 to 8.8

With Camunda 8.8, the default docker-compose.yaml deploys the Orchestration Cluster and connectors. Web Modeler must be deployed using a separate Docker Compose configuration.

For production environments, use Kubernetes with the official Camunda Helm chart or create a custom deployment process using Infrastructure as Code tools such as Terraform, Ansible, or AWS CloudFormation.

Upgrade components​

Some upgrades require additional component-level steps depending on which components you use or how your environment is configured. Follow the upgrade guide for your deployment method and for any required component-specific changes or migrations.

Component upgrade from 8.7 to 8.8

8.8 release information​

Learn about new features, breaking changes, and deprecations in Camunda 8.8:

Upgrading from an earlier version​

Camunda 8 upgrades must be performed sequentially.

  • You must upgrade from the latest patch version of your current Camunda release to the latest patch version of the next release.
  • For example, you must upgrade from 8.6 to 8.7 before you can upgrade to 8.8.
  • Do not skip releases.

Use the following version-specific upgrade guides to upgrade to Camunda 8.7 before you can proceed with the 8.8 upgrade.

note

Each guide covers only the changes required for that specific version upgrade.

Kubernetes with Helm​

Component-based upgrades​