Skip to content

Compatibility Matrix

Günter Wirth edited this page Oct 21, 2026 · 44 revisions

Use the cxx plugin Compatibility Matrix to select the correct plugin version for the SonarQube version you are using. SonarQube versions are based on different Java versions and also have different APIs and UIs.

SonarQube
version
Plugin
API
Java
version
cxx plugin
version
v1.3.3 v2.0.x v2.1.x v2.2.x v2.3.x v2.4.x *
6.7.x LTS - Java 8 X - - - - -
7.9.x LTA - Java 11 X X - - - -
8.9.x LTA - Java 11 - X X - - -
9.9.x LTA - Java 17 - - X X - -
Community 25.1 13.0.0.3026 Java 17 - - - X - -
Server 2025.1.x LTA 13.0.0.3026 Java 17 - - - X - -
Community 25.8 13.0.0.3026 Java 17 - - - X X -
Server 2025.4.x LTA 13.0.0.3026 Java 17 - - - X X -
Community 26.1 13.4.3.4290 Java 21 - - - - X -
Server 2026.1.x LTA 13.4.3.4290 Java 21 - - - - X -
Community 26.1 14.0.0.4498 Java 21 - - - - - X
Server 2026.1.x LTA 14.0.0.4498 Java 21 - - - - - X
Community 26.9 14.0.0.4498 Java 21 - - - - - X
Server 2026.5.x LTA 14.0.0.4498 Java 21 - - - - - X

- not tested
* upcoming release

Download Links

Plugin Compatibility (cxx plugin)

As a general rule, only LTS versions are supported by the cxx plugin. Intermediate versions are often not stable enough and break API compatibility. The maintenance effort of all variants would be too high. We only do testing with the Community version and assume that a Server version is compatible if it use the same Plugin API version.

Please always review the SonarQube Release Notes when upgrading to a new SonarQube version. These release notes include important information about 'Deprecations and Removals', which describe changes to features and API endpoints that may impact plugin compatibility. For further details, refer to the Deprecation Policy.

API Compatibility

Breaking changes to the SonarQube API occur only when the major version changes. As a result:

  • Plugins should remain compatible with future versions of the API within the same major version.
  • New APIs can be introduced in any release.
  • Plugins may perform runtime version checks to determine whether newly introduced APIs are available, depending on the target platform.

Plugin API Version Mapping

An overview of SonarQube versions and their corresponding Plugin API versions can be found here:

Clone this wiki locally