This document details the version compatibility of components of Develocity with other related components.

Develocity Gradle plugin

Latest version: 3.19 (2024-12-12)

It is recommended to always use the latest version of the Develocity Gradle plugin that is compatible with your Gradle Build Tool version and installed Develocity version, as it will produce the most insightful Build Scans. See the Develocity Gradle Plugin User Manual for more information on using the Develocity Gradle plugin.

This plugin was previously named and referred to as the “Build Scan” plugin. With the release of Gradle 6.0 and version 3.0 of this plugin, it has been renamed to the “Develocity” plugin. When being used with earlier than Gradle 6.0, it is still referred to and used as the “Build Scan” plugin.

Gradle Build Tool compatibility

Upgrading your Gradle version may require updating the Develocity Gradle plugin version.

Build Scans

For Gradle version 2.0 until 4.10.3, apply the Build Scan Gradle Plugin as described here. For Gradle 5.0+, apply the Develocity Gradle Plugin as described here.

Gradle Build Tool versions Minimum plugin version Maximum plugin version

≥ 6.0

3.0

3.19

5.0 - 5.6.4

2.0.2

3.19

4.1 - 4.10.3

1.8

1.16

4.0

1.7.4

1.16

2.0 - 3.5

1.0

1.16

< 2.0

not supported

not supported

Predictive Test Selection and Test Distribution

The minimum version for the Gradle Build Tool that works with Predictive Test Selection and Test Distribution is 5.4.

Gradle Build Tool version Minimum plugin version Maximum plugin version

≥ 5.4

3.11

3.19

< 5.4

not supported

not supported

The functionality of the Develocity Test Distribution Gradle plugin was merged into the Develocity Gradle plugin as of version 3.11 as part of the Develocity 2022.3 release. Please use the Develocity Test Distribution Gradle plugin for Predictive Test Selection and Test Distribution on Develocity 2022.2 and earlier.

Develocity compatibility

Major or minor version updates to the Develocity Gradle plugin indicate a compatibility change with Develocity (e.g. 3.0 → 3.1 or 3.1 → 4.0). Patch number only updates (e.g. 3.0 → 3.0.1) do not affect compatibility.

Submitting a Build Scan with an incompatible Develocity Gradle plugin version will result in a warning message and the submission will be rejected.

Develocity versions Minimum plugin version Maximum plugin version

2024.3

1.0

3.19

2024.2

1.0

3.18.2

2024.1

1.0

3.17.6

2023.4

1.0

3.16.2

2023.3

1.0

3.15.1

2023.2

1.0

3.14.1

2023.1

1.0

3.13.4

2022.4

1.0

3.12.6

2022.3

1.0

3.11.4

2022.2

1.0

3.10.3

2022.1

1.0

3.9

2021.4

1.0

3.8.1

2021.3

1.0

3.7.2

2021.1 - 2021.2

1.0

3.6.4

2020.4 - 2020.5

1.0

3.5.2

2020.3

1.0

3.4.1

2020.2

1.0

3.3.4

2020.1

1.0

3.2.1

2019.4 - 2019.5

1.0

3.1.1

2019.3.3 - 2019.3.5

1.0

3.0

2019.3 - 2019.3.2

1.0

2.4.2

2019.2

1.0

2.3

2019.1

1.0

2.2.1

2018.5

1.0

2.1

2018.4.2

1.0

2.0.2

2018.4 - 2018.4.1

1.0

1.16

2018.3

1.0

1.15.2

2018.2

1.0

1.13.4

2018.1

1.0

1.12.1

2017.7

1.0

1.11

2017.6

1.0

1.10.3

2017.5

1.0

1.9.1

2017.4

1.0

1.8

2017.3

1.0

1.7.4

2017.1 - 2017.2

1.0

1.6

2016.4

1.0

1.3

2016.3

1.0

1.1.1

2016.0 - 2016.2

1.0

1.0

Test Retry Gradle plugin

When using the Test Retry Gradle plugin together with the Develocity Gradle plugin for Test Distribution or Predictive Test Selection, make sure to use the minimum required version as shown below:

Develocity Gradle plugin Minimum Test Retry plugin version

≥ 3.11

1.1.4

Develocity Maven extension

Latest version: 1.23 (2024-12-12)

It is recommended to always use the latest version of the extension that is compatible with your Apache Maven™ version and installed Develocity version, as it will produce the most insightful Build Scans and provide the most performant build caching. See the Develocity Maven Extension User Manual for more information on using the extension.

Apache Maven compatibility

The latest version of the extension is guaranteed to be compatible with Apache Maven 3.3.1+.

Apache Maven versions Minimum extension version Maximum extension version

≥ 3.9.6

1.17.3

1.23

3.3.1 - 3.9.5

1.0

1.23

< 3.3.1

not supported

not supported

Java runtime requirements

The latest version of the extension runs on Java 1.8 and above.

Java runtime versions Minimum extension version Maximum extension version

≥ 1.8

1.0

1.23

< 1.8

not supported

not supported

Develocity compatibility

Major or minor version updates to the extension indicate a compatibility change with Develocity (e.g. 1.0 → 1.1 or 1.0 → 2.0). Patch number only updates (e.g. 1.0 → 1.0.1) do not affect compatibility.

Submitting a Build Scan or accessing the Build Cache with an incompatible extension version will result in a warning message and the submission or request will be rejected.

Develocity versions Minimum extension version Maximum extension version

2024.3

1.0

1.23

2024.2

1.0

1.22.2

2024.1

1.0

1.21.6

2023.4

1.0

1.20.1

2023.3

1.0

1.19.3

2023.2

1.0

1.18.4

2023.1

1.0

1.17.4

2022.4

1.0

1.16.6

2022.3

1.0

1.15.5

2022.2

1.0

1.14.4

2022.1

1.0

1.13.1

2021.4

1.0

1.12.4

2021.3

1.0

1.11.1

2021.2

1.0

1.10.5

2021.1

1.0

1.9.2

2020.5

1.0

1.8.3

2020.4

1.0

1.7.2

2020.3

1.0

1.6.8

2020.2

1.0

1.5.3

2020.1

1.0

1.4.1

2019.4 - 2019.5

1.0

1.3.6

2019.3

1.0

1.2.8

2019.2

1.0

1.1.4

2019.1

1.0

1.0.8

< 2019.1

not supported

not supported

Develocity sbt plugin

Latest version: 1.1.2 (2024-10-25)

It is recommended to always use the latest version of the plugin that is compatible with your sbt version and installed Develocity version, as it will produce the most insightful Build Scans. See the Develocity sbt Plugin User Manual for more information on using the Develocity sbt plugin.

sbt compatibility

The latest version of the plugin is guaranteed to be compatible with sbt 1.6.0 onwards.

sbt versions Minimum plugin version Maximum plugin version

≥ 1.6.0

0.9

1.1.2

< 1.6.0

not supported

not supported

Develocity compatibility

Major or minor version updates to the plugin indicate a compatibility change with Develocity (e.g. 1.0 → 1.1 or 1.0 → 2.0). Patch number only updates (e.g. 1.0 → 1.0.1) do not affect compatibility.

Submitting a Build Scan with an incompatible plugin version will result in a warning message and the submission will be rejected.

Develocity versions Minimum plugin version Maximum plugin version

2024.3

0.9

1.1.2

2024.2

0.9

1.1.2

2024.1

0.9

1.0.1

2023.4

0.9

0.10.1

2023.3

0.9

0.10.1

2023.2

0.9

0.9

< 2023.2

not supported

not supported

Develocity Bazel compatibility

The "Minimum" and "Maximum" Bazel versions listed are the oldest and newest versions that were tested as part of the release, rather than an indication that anything newer or older will certainly not work.

See the Develocity release notes for changes that are known to be backward-incompatible with specified versions of Bazel.

Develocity versions Minimum Bazel version Maximum Bazel version

2024.3

5.4.1

7.4.1

2024.2

5.4.1

7.4.1

2024.1

4.2.1

7.1.0

< 2024.1

not supported

not supported

Develocity npm agent

Latest version: 0.9.0 (2024-12-12)

It is recommended to always use the latest version of the agent that is compatible with your npm version and installed Develocity version, as it will produce the most insightful Build Scans. See the Develocity npm agent User Manual for more information on using the Develocity npm agent.

npm compatibility

The latest version of the plugin is guaranteed to be compatible with npm 10 onwards.

npm versions Minimum agent version Maximum agent version

≥ 10

0.9.0

0.9.0

< 10

not supported

not supported

Node.js compatibility

The latest version of the agent requires Node.js version 18.20.5 or above.

Node.js versions Minimum agent version Maximum agent version

≥ 18.20.5

0.9.0

0.9.0

< 18.20.5

not supported

not supported

Develocity compatibility

Major or minor version updates to the plugin indicate a compatibility change with Develocity (for example, 1.0 → 1.1 or 1.0 → 2.0). Patch number-only updates (for example, 1.0 → 1.0.1) do not affect compatibility.

Submitting a Build Scan with an incompatible agent version will result in a warning message and the submission will be rejected.

Develocity versions Minimum agent version Maximum agent version

2024.3

0.9.0

0.9.0

< 2024.3

not supported

not supported

Develocity Python agent

Latest version: 0.9 (2024-12-12)

It is recommended to always use the latest version of the agent that is compatible with your Python version and installed Develocity version, as it will produce the most insightful Build Scans. See the Develocity Python agent User Manual for more information on using the Develocity Python agent.

Python compatibility

The latest version of the plugin is guaranteed to be compatible with Python 3.9.0 onwards.

Python versions Minimum agent version Maximum agent version

≥ 3.9.0

0.9

0.9.0

< 3.9.0

not supported

not supported

Develocity compatibility

Major or minor version updates to the plugin indicate a compatibility change with Develocity (for example, 1.0 → 1.1 or 1.0 → 2.0). Patch number-only updates (for example, 1.0 → 1.0.1) do not affect compatibility.

Submitting a Build Scan with an incompatible agent version will result in a warning message and the submission will be rejected.

Develocity versions Minimum agent version Maximum agent version

2024.3

0.9

0.9

< 2024.3

not supported

not supported

Build Cache node

Latest version: 20.0 (2024-08-19)

It is recommended to always use the latest version of the Build Cache node. See the Build Cache Node User Manual for more information on using and installing a Build Cache node.

With the release of Develocity 2024.3, support for Build Cache node versions older than 14.0 has officially ended.
As a result, these older versions will no longer be able to connect to Develocity 2024.3 and future releases. Additionally, critical security vulnerability patches will not be backported to these now unsupported versions.

If you have any questions or need any assistance, don’t hesitate to contact the Develocity support team.

Develocity compatibility

Major version updates to the remote cache node indicate a compatibility change with Develocity (e.g. 1.0 → 2.0). Minor number only updates (e.g. 3.0 → 3.1) do not affect compatibility.

Develocity versions Minimum Build Cache node version Maximum Build Cache node version

2024.2

1.0

20.0

2024.1

1.0

19.2

2023.4

1.0

18.1

2023.3

1.0

17.1

2023.2

1.0

16.1

2023.1

1.0

15.1

2022.4

1.0

14.0

2022.3

1.0

13.3

2022.1 - 2022.2

1.0

12.5

2021.4

1.0

11.2

2021.3

1.0

10.3

2019.4 - 2021.2

1.0

9.11

2019.3.1

1.0

8.1

2019.1 - 2019.3

1.0

7.1

2018.5

1.0

6.0

2018.4

1.0

5.2

2018.2 - 2018.3

1.0

4.3

2017.7 - 2018.1

1.0

3.2

2017.6

1.0

2.0

2017.4 - 2017.5

1.0

1.2

< 2017.4

not supported

not supported

Configuration schema

The YAML configuration schema is released at a different rate to that of the node. Nodes will always parse configuration files with a version less than the maximum schema version.

Schema versions can be downloaded from the Build Cache node manual Appendix B.

Build Cache node version Maximum schema version

≥ 12.0

5

11.0 - 11.2

4

10.0 - 10.3

3

6.0 - 9.11

2

4.2 - 5.2

1

< 4.2

not supported

Jar version Java runtime requirements

Since Build Cache node 15.0 we require a Java 17 runtime to run the JAR version of the Build Cache node. Prior to this, Java 11 was required.

Build Cache node version Minimum Java runtime version

≥ 15.0

17

9.0 - 14.0

11

< 9.0

8

Develocity Test Distribution Gradle plugin

The functionality of the Develocity Test Distribution Gradle plugin was merged into the Develocity Gradle plugin as of version 3.11 as part of the Develocity 2022.3 release. Starting with the version 2024.2, Develocity no longer supports the Test Distribution Gradle plugin.

Last version: 2.3.5 (2022-07-01)

Develocity compatibility

Develocity 2020.2 is the first release that supports Test Distribution.

Develocity versions Minimum plugin version Maximum plugin version

≥ 2024.2

not supported

not supported

2023.1 - 2024.1

2.2

2.3.5

2022.2 - 2023.1

1.1

2.3.5

2021.3 - 2022.1

1.1

2.2.3

2021.2

1.1

2.1.1

2021.1

1.1

2.0.3

2020.5

1.1

1.3.3

2020.4

1.1

1.2.1

2020.3

1.1

1.1.5

2020.2

1.0

1.0.2

< 2020.2

not supported

not supported

Gradle Build Tool compatibility

The minimum version for the Gradle Build Tool which works with Test Distribution is 5.4.

Gradle Build Tool version Minimum plugin version Maximum plugin version

≥ 7.6

2.3.4

2.3.5

6.8 - 7.5

1.3

2.3.5

6.7

1.1.2

2.3.5

5.4 - 6.6

1.0

2.3.5

< 5.4

not supported

not supported

Test Retry Gradle plugin

When using the Test Retry Gradle plugin together with the Develocity Test Distribution Gradle plugin, make sure to use the minimum required version as shown below:

Develocity Test Distribution Gradle plugin Minimum Test Retry plugin version

≥ 1.0

1.1.4

Develocity Test Distribution agent

Latest version: 3.2 (2024-12-12)

It is recommended to always use the latest version of the Develocity Test Distribution agent. See the Develocity Test Distribution Agent User Manual for more information on using and installing a Test Distribution agent.

Develocity compatibility

Develocity 2020.2 is the first release which supports Test Distribution.

Develocity versions Minimum agent version Maximum agent version

2024.3

3.0

3.2

2024.2

3.0

3.1.1

2024.1

1.6

3.0.1

2023.4

1.6

2.1

2023.2 - 2023.3

1.6

2.0.3

2023.1

1.1

2.0.3

2021.3 - 2022.4

1.1

1.6.14

2021.2

1.1

1.5

2021.1

1.1

1.4.1

2020.5

1.1

1.3.2

2020.4

1.1

1.2

2020.3

1.1

1.1.2

2020.2

1.0

1.0

< 2020.2

not supported

not supported

Jar version Java runtime requirements

The Develocity Test Distribution agent requires a Java 17 runtime.

Test Distribution Agent Minimum Java runtime version

≥ 3.0

21

2.0 - 2.1

17

1.0 - 1.6.14

11

Develocity Admin CLI tool

Latest version: 1.12 (2024-08-19)

Some Admin CLI commands are self-contained and do not connect to a Develocity instance. These can be run regardless of the installed Develocity version.

For commands that connect to a Develocity instance, see the table below.

It is recommended to always use the latest version of the Develocity Admin CLI tool. See the Develocity Admin CLI User Manual for more information on using and installing the tool.

Develocity compatibility

Develocity 2021.4 is the first release which supports connections from the Develocity Admin CLI tool.

Develocity versions Minimum tool version Maximum tool version

2024.1 - 2024.2

1.11

1.12

2023.3 - 2023.4

1.8

1.12

2022.4 - 2023.2

1.6

1.12

2022.2 - 2022.3

1.3

1.5.1

2021.4 - 2022.1

1.2

1.5.1

< 2021.4

not supported

not supported

Jar version Java runtime requirements

The Develocity Test Distribution agent requires a Java 11 runtime.

Develocity Admin CLI tool Minimum Java runtime version

1.0 - 1.8.1

11

1.9

17

≥ 1.10

21

Kubernetes, K3s, and Helm

It is recommended to always use the latest versions of Helm and Kubernetes (or K3s for standalone installations) that is compatible with your installed Develocity version.

Develocity K3s compatibility

K3s versioning reflects the versions of upstream Kubernetes releases. For example, the K3s release v1.27.4+k3s1 maps to the v1.27.4 Kubernetes release. As such, you can identify the K3s versions Develocity is compatible with using the Kubernetes compatability table below. You can see the available versions of K3s on their releases page.

See the K3s release cadence documentation for details.

Develocity Kubernetes compatibility

The versions of Kubernetes that are supported by Develocity follow the officially supported Kubernetes versions. Kubernetes compatibility is only updated for major releases of Develocity.

Develocity versions Minimum Kubernetes version Maximum Kubernetes version

2024.3

1.29

1.31

2024.2

1.28

1.30

2024.1

1.26

1.29

2023.3 - 2023.4

1.11

1.27

2022.2 - 2023.2

1.11

1.24

2021.4 - 2022.1

1.9

1.20

K3s versioning reflects the versions of upstream Kubernetes releases. For example, the K3s release v1.27.4+k3s1 maps to the v1.27.4 Kubernetes release.

Develocity Helm compatibility

Develocity versions Minimum Helm version Maximum Helm version

2024.3

3.14

3.16

2024.2

3.13

3.15

2024.1

3.11

3.13

2023.3 - 2023.4

2.11

3.12

2022.2 - 2023.2

2.11

3.9

2021.4 - 2022.1

2.8

3.5

Develocity upgrade and backup restoration compatibility

Some older versions of Develocity need to be upgraded via an intermediate version. The same behaviour applies to backups from older versions that are restored - these need the same upgrade compatibility to the current version as upgrading a Develocity installation in-place.

At this time, all versions prior to 2018.5 must be upgraded via an intermediate version. In some rare circumstances later versions up to 2020.1.2 may also need an intermediate version, depending on database state. All other versions can be upgraded to the latest Develocity directly.

If your installation needs an intermediate version installed in order to upgrade to the latest version, a message will be displayed (or signed in Kubernetes installations) when attempting to start the new Develocity version, indicating that the previous version is not upgrade-compatible with the current version, and to contact Gradle support. A step-by-step process will then be provided by Gradle support to install the necessary intermediate version and finish any incomplete data migration, before then upgrading to the latest version.