This document details the version compatibility of components of Develocity with other related components.
Develocity Gradle plugin
Latest version: 4.0.1 (2025-04-25)
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 |
4.0.1 |
|
5.0 - 5.6.4 |
2.0.2 |
4.0.1 |
|
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 |
4.0.1 |
|
< 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 |
|---|---|---|
|
2025.1 |
1.0 |
4.0.1 |
|
2024.3 |
1.0 |
3.19.2 |
|
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: 2.0 (2025-04-08)
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 |
2.0 |
|
3.3.1 - 3.9.5 |
1.0 |
2.0 |
|
< 3.3.1 |
not supported |
not supported |
Java Runtime Requirements
| Maven Extension version | Minimum Java runtime version |
|---|---|
|
1.0 - 2.0 |
≥ 8 |
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 |
|---|---|---|
|
2025.1 |
1.0 |
2.0 |
|
2024.3 |
1.0 |
1.23.2 |
|
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 |
Build Cache node compatibility
The minimum version of the Build Cache node that is guaranteed to work properly is 7.0.
| Build Cache node version | Minimum extension version | Maximum extension version |
|---|---|---|
|
21.0 - 21.0 |
2.0 |
2.0 |
|
18.0 - 20.2 |
1.20 |
1.23.2 |
|
7.0 - 18.0 |
1.0 |
1.19.3 |
Develocity sbt plugin
Latest version: 1.2.1 (2025-05-01)
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.2.1 |
|
< 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 |
|---|---|---|
|
2025.1 |
0.9 |
1.2.1 |
|
2024.3 |
0.9 |
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 |
|---|---|---|
|
2025.2 |
6.5.0 |
8.2.1 |
|
2025.1 |
6.5.0 |
8.1.1 |
|
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.10.1 (2025-05-09)
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.10.1 |
|
< 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.10.1 |
|
< 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 |
|---|---|---|
|
2025.1 |
0.9.0 |
0.10.1 |
|
2024.3 |
0.9.0 |
0.9.1 |
|
< 2024.3 |
not supported |
not supported |
Develocity Python agent
Latest version: 0.10 (2025-04-08)
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.10 |
|
< 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 |
|---|---|---|
|
2025.1 |
0.9 |
0.10 |
|
2024.3 |
0.9 |
0.9.1 |
|
< 2024.3 |
not supported |
not supported |
Build Cache node
Latest version: 21.0 (2025-04-08)
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.
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 |
|---|---|---|
|
2025.1 |
14.0 |
21.0 |
|
2024.3 |
14.0 |
20.2 |
|
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 |
Java Runtime Requirements
| 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.3 (2025-04-08)
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 |
|---|---|---|
|
2025.1 |
3.0 |
3.3 |
|
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 |
Java Runtime Requirements
| Test Distribution Agent | Minimum Java runtime version |
|---|---|
|
≥ 3.0 |
21 |
|
2.0 - 2.1 |
17 |
|
1.0 - 1.6.14 |
11 |
Develocityctl
Latest version: 1.15 (2025-04-08)
Some develocityctl 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 develocityctl. See the develocityctl manual for more information on using and installing the tool.
Develocity compatibility
Develocity 2021.4 is the first release that includes support for develocityctl. |
| Develocity versions | Minimum develocityctl version |
Maximum develocityctl version |
|---|---|---|
|
2025.1 |
1.13 |
1.15 |
|
2024.1 - 2024.3 |
1.11 |
1.15 |
|
2023.3 - 2023.4 |
1.8 |
1.15 |
|
2022.4 - 2023.2 |
1.6 |
1.15 |
|
2022.2 - 2022.3 |
1.3 |
1.5.1 |
|
2021.4 - 2022.1 |
1.2 |
1.5.1 |
|
< 2021.4 |
not supported |
not supported |
Java Runtime Requirements
develocityctl version |
Minimum Java runtime version |
|---|---|
|
≥ 1.10 |
21 |
|
1.9 |
17 |
|
1.0 - 1.8.1 |
11 |
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 |
|---|---|---|
|
2025.1 |
1.30 |
1.32 |
|
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 |
|---|---|---|
|
2025.1 |
3.15 |
3.17 |
|
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 to an intermediate version before they can be upgraded to the latest version. Similarly, database backups from those older versions of Develocity need to first be restored into instances of an intermediate version, at which point that intermediate version can then be upgraded to the latest version in order to effectively restore the backup into an instance running the latest version of Develocity. The below table describes the steps to take when attempting to either upgrade or restore a database backup from an older version of Develocity.
| Current Develocity version | Required intermediate upgrades to get to the latest Develocity version |
|---|---|
|
version < 2020.2 |
Contact Develocity support. |
|
2020.2 ⇐ version < 2021.1 |
Upgrade to 2023.2.3, then, after the application is running again, upgrade to the latest Develocity version |
|
2021.1 ⇐ version < 2023.3 |
In the vast majority of cases, you can upgrade directly to the latest version of Develocity. There are rare circumstances in which you must first upgrade to 2023.2.3, and then to the latest Develocity version, depending on database state. This can only be possible (but is still unlikely) if your database has previously been upgraded from a version prior to 2020.4, and it either hasn’t spent much time running, or had a large number (hundreds of thousands or more) of build scans stored in the database. |
|
version >= 2023.3 |
Upgrade directly to the latest version of Develocity. |
If your installation or database backup needs an intermediate version installed in order to upgrade to the latest version, contact Gradle support. We will provide a step-by-step process to install the necessary intermediate version(s), accommodating changes in Develocity configuration, and finish any incomplete data migration, before then upgrading to the latest version.