Skip to content

Upgrading Camunda 8.7.x Job Worker to Spring Boot 4.x

This document is an upgrade guide for consumers who already have a Camunda 8.7.x Job Worker application running with Spring Boot 3.x. It covers only the changes required to upgrade the application to Spring Boot 4.x.

If you are upgrading the application from Camunda 8.6.x, apply the changes from the Camunda 8.7.x upgrade guide before following this guide.

Step 1: Update the Spring Boot Version

In your pom.xml, update the Spring Boot parent version from 3.x.x to an approved 4.0.x version:

Before

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.5.5</version>
    <relativePath/>
</parent>

After

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>4.0.7</version>
    <relativePath/>
</parent>

Step 2: Update the Camunda Starter

Spring Boot 4 support is available starting with Camunda SDK version 8.7.24.

Replace the existing Spring Boot 3 Camunda starter:

Before

<dependency>
    <groupId>io.camunda</groupId>
    <artifactId>spring-boot-starter-camunda-sdk</artifactId>
    <version>8.7.27</version>
</dependency>

After

<dependency>
    <groupId>io.camunda</groupId>
    <artifactId>camunda-spring-boot-4-starter</artifactId>
    <version>8.7.27</version>
</dependency>

Use version 8.7.24 or later. The example above uses 8.7.27, consistent with the Camunda 8.7.x Job Worker upgrade guide.

NOTE: camunda-spring-boot-4-starter must be used with Spring Boot 4.x. The existing spring-boot-starter-camunda-sdk and camunda-spring-boot-3-starter artifacts are intended for Spring Boot 3.x.

Step 3: Build the Application

Run the Maven build after updating the dependencies:

./mvnw clean test

Resolve any compatibility issues from application-specific dependencies before deploying the application.

No application.yml Changes Required

The existing Camunda 8.7.x configuration remains the same when upgrading from Spring Boot 3.x to Spring Boot 4.x.

Continue using:

  • camunda.client.tenant-id
  • camunda.client.auth.token-url
  • The existing Zeebe gRPC or REST connection properties

No Job Worker Code Changes Required

Existing @JobWorker implementations, variable handling, custom headers, and automatic job completion remain compatible.

No changes are required to the Job Worker implementation solely for the Spring Boot 4.x upgrade.