Release upgrade notes (2024)

Release 9.9 upgrade notes

Database support updated

• SonarQube no longer supports Oracle version 12C and 18C.
• Oracle version 21C is now supported.
• SQL Server 2022 is now supported.

• Recommended Docker Engine version is 20.10 and later.
• If you use self-signed certificates, you may need to adjust your Docker configuration: the path of the Java installation has changed to /opt/java/openjdk/. See Install the server for more information.
• The deprecated SONARQUBE_JDBC_USERNAME, SONARQUBE_JDBC_PASSWORD, and SONARQUBE_JDBC_URL variables have been removed. See Environment variables for up-to-date configuration variables.
• The lts tag on Docker images is replaced with the new LTS release. If you want to avoid any automatic major upgrades, we recommend using the corresponding 9.9-<edition> tag instead of lts-<edition>.

Release 9.8 upgrade notes

New main branch names default to “main”
In the past, newly created projects and applications would have a main branch called “master”. This has now been changed to “main”. The default value for a newly created main branch name can be changed under Administration > General > Default main branch name. See the branch analysis documentation for more information. (SONAR-17524)

Database support updated

• PostgreSQL versions <11 are no longer supported.
• Supported versions are now from 11 to 15.

SonarQube server supports Java 17
SonarQube server now supports Java 17. See the documentation onprerequisitesfor more information. (SONAR-17565)

Full release notes

Release 9.7 upgrade notes

Change in the database connection pool
The database connection pool has been replaced for better performance. Thesonar.jdbc.maxIdle,sonar.jdbc.minEvictableIdleTimeMillisandsonar.jdbc.timeBetweenEvictionRunsMillisproperties no longer have any effect and should be removed from the configuration. Also, the JMX information that is provided to monitor the connection pool has evolved. See theMonitoring documentationfor more information. (SONAR-17200).

JavaScript, TypeScript, and CSS analysis now requires Node.js 14.17+
In order to analyze Javascript, Typescript, and CSS code, Node.js 14.17+ must be installed on the machine running the scan. We recommend that you use the latest Node.js LTS, which is currently Node.js 18.

Full release notes

Release 9.6 upgrade notes

Microsoft SQL Server changes in configuration and Integrated Authentication

• If your Microsoft SQL Server doesn't support encryption, you will need to addencrypt=falseto the JDBC URL connection string. (SONAR-16249).
• If your Microsoft SQL Server requires encryption but you don't want SonarQube to validate the certificate, you will need to addtrustServerCertificate=trueto the JDBC URL connection string.
• If you are using Microsoft SQL Server with Integrated Authentication, you will need to replace themssql-jdbc_authdll file on yourPATHwithmssql-jdbc_auth-10.2.1.x64.dllfrom theMicrosoft SQL JDBC Auth 10.2.1 package. SeeInstall the serverfor more information.

Token expiry
New tokens can now have an optional expiration date. Expired tokens cannot be used and must be updated. WithEnterprise editionandabove, system administrators can set a maximum lifetime for new tokens. SeeSecuritydocumentation for more information. (SONAR-16565,SONAR-16566).

Running SonarQube as a Service and Java version selection

• To install, uninstall, start or stop SonarQube as a service on Windows, now you should use%SONAR_HOME%\bin\windows-x86-64\SonarService.bat install. SeeConfiguring and operating the serverandUpgrade guidefor more information.
• If there are multiple versions of Java installed on your server, to select specific Java version to be used, set the environment variableSONAR_JAVA_PATH. Read morehere.

Full release notes

Release 9.5 upgrade notes

Project analysis token
You can now generate tokens of different types and can create a different analysis token for every specific project. The new tokens will include a prefix to help you quickly identify SonarQube tokens and their type. The usage of project analysis tokens is encouraged to limit the access this token has. SeeGenerating and using tokensdocumentation for more information. (SONAR-16260).

Full release notes

Release 9.4 upgrade notes

Password of old inactive account needs reset
The support for SHA1 hashed password has been removed. This algorithm was replaced by a stronger hashing algorithm since version 7.2. As a result, local accounts that did not log in since 7.2 will be forced to have their password reset by a SonarQube administrator. Accounts using external authentication such as SAML, LDAP, GitHub authentication, etc., are not impacted. Information about the possibly impacted accounts will appear in the logs during the upgrade. (SONAR-16204).

Full release notes

Release 9.3 upgrade notes

Portfolio overview now shows ratings on both New Code and Overall Code
The Portfolio overview and project breakdown have been redesigned to provide a high-level view on project health according to your New Code definition as well as Overall Code. New Code ratings are shown for Reliability, Security Vulnerabilities, Security Review, and Maintainability. To see these ratings on New Code, Portfolios need to be recomputed after upgrading to 9.3.

Along with this redesign, Portfolios and Applications no longer show users information on projects they don't have access to, and Application administration has been moved out of the Portfolio administration UI.

Microsoft SQL Server and Integrated Authentication
If you are using Microsoft SQL Server with Integrated Authentication, you will need to replace themssql-jdbc_auth-9.2.0.x64.dllfile on yourPATHwithmssql-jdbc_auth-9.4.1.x64.dllfrom theMicrosoft SQL JDBC Driver 9.4.1 package. SeeInstall the serverfor more information.

Full release notes

Release 9.2 upgrade notes

Bitbucket Cloud authentication now built-in
Support for Bitbucket Cloud authentication is now built-in. If you were using the Bitbucket Cloud authentication plugin before, you need to remove it from SonarQube before upgrading.

SonarQube uses the same settings as the plugin, so you do not need to update them. The Teams restriction has been replaced with the Workspaces restriction and is migrated accordingly.

Full release notes

Release 9.1 upgrade notes

Secured settings no longer available in web services and on the scanner side
This change especially affects the analysis of SVN projects but also, possibly, the use of some 3rd-party plugins. Secured settings required to perform the analysis now need to be passed to the scanner as parameters.

Custom measures feature has been dropped
The custom measures feature, which was previously deprecated, has been removed. (SONAR-10762).

Deprecated WebAPI endpoints and parameters removed
The WebAPI endpoints and parameters deprecated during the 7.X release cycle have been removed. For a complete list of removed endpoints and parameters seeSONAR-15313.

Full release notes

Release 9.0 upgrade notes

Scanners require Java 11
Java 11 is required for SonarQube scanners. Java 8 is no longer supported. SeeScanner environmentfor more information.

Support for Internet Explorer 11 dropped
Support for Internet Explorer 11 and other legacy browsers has been dropped. (SONAR-14387).

Reporting Quality Gate status on GitHub branches requires an additional permission
When working in private GitHub repositories, you need to grant read-only access to theContentspermission on the GitHub application that you're using for SonarQube integration. SeeGitHub integrationfor more information.

JavaScript custom rule API removed
The JavaScript custom rule API, which was previously deprecated, has been removed. Plugins can no longer use this API to implement custom rules. See theJavaScript documentationfor more information. (SONAR-14928).

Deprecated Plugin Java API dropped
Parts of the Java API for plugins that were deprecated before SonarQube 7.0 have been dropped. You should compile plugins against SonarQube 9.0 to ensure they're compatible and to check if they're using a deprecated API that has been dropped. (SONAR-14925,SONAR-14885).

Full release notes

Release 8.9 upgrade notes

GitHub Enterprise compatibility
SonarQube 8.9 only supports GitHub Enterprise 2.21+ for pull request decoration (the previous minimum version was 2.15).

Plugins require risk consent
When upgrading, if you're using plugins, a SonarQube administrator needs to acknowledge the risk involved with plugin installation when prompted in SonarQube.

Database support updated
SonarQube 8.9 supports the following database versions:

• PostgreSQL versions 9.6 to 13. PostgreSQL versions <9.6 are no longer supported.
• MSSQL Server 2014, 2016, 2017, and 2019.
• Oracle XE, 12C, 18C, and 19C. Oracle 11G is no longer supported.

Webhooks aren't allowed to target the instance
To improve security, webhooks, by default, aren't allowed to point to the SonarQube server. You can change this behavior in the configuration. (SONAR-14682).

Full release notes