Skip to main content
Version: 8.9 (unreleased)

Upgrade to Camunda 8.9

note

This section is a work in progress for Camunda 8.9 and will be updated as upgrade requirements are finalized.

If you need details that are not yet covered here, see:

Upgrade a Camunda 8 Self-Managed deployment from version 8.8 to 8.9. This guide applies to Self-Managed installations only and does not apply to Camunda SaaS.

If your deployment is running a version earlier than 8.8, complete the required version-specific upgrades listed in Upgrading from an earlier version before proceeding.

Prepare for upgrade​

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

Prepare for upgrade

Upgrade methods​

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

Kubernetes with Helm icon

Kubernetes with Helm

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

Manual icon

Manual

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

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.8 to 8.9 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.8 to 8.9

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.

Component-specific upgrade guidance​

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 refer to this guide for any component-specific changes or migrations required for your setup.

Component upgrade from 8.8 to 8.9

Release notes and changes in 8.9​

For details about new features, breaking changes, and deprecations in Camunda 8.9, see:

Upgrading from an earlier version​

Camunda 8 upgrades must be performed sequentially. Upgrade from the latest patch version of your current Camunda release to the latest patch version of the next release.

For example, upgrade from 8.7 to 8.8 before upgrading to 8.9. Do not skip releases.

Use the version-specific upgrade guides below to reach Camunda 8.8 before proceeding with the 8.9 upgrade.

Kubernetes with Helm​

Component-based upgrades​

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