Performing the upgrade
Now that you have determined your upgrade path and performed the pre-upgrade steps, you can proceed with your upgrade.
Upgrading a ZIP file instance
Before you upgrade, make sure you know how to install SonarQube from the ZIP file and check that your environment meets the requirements of your target version.
To upgrade from the ZIP file:
- Download and unzip the SonarQube Community Build distribution in a fresh directory, let's say
<newSonarqubeHome>. - If you're using third-party plugins, manually install plugins that are compatible with your version of SonarQube Community Build. Use the plugin version matrix to ensure that the versions you install are compatible with your SoanrQube version. Simply copying plugins from the old instance to the new is not recommended; incompatible or duplicate plugins could cause startup errors.
- Update the contents of
sonar.propertiesfile (in<newSonarqubeHome>/conf) with the settings in the<oldSonarqubeHome>/confdirectory (web server URL, database, ldap settings, etc.). Do not copy-paste the old files. If you are using the Oracle DB, copy its JDBC driver into<newSonarqubeHome>/extensions/jdbc-driver/oracle. - Stop your old SonarQube Community Build.
- Start your new SonarQube Community Build.
- Browse to
http://yourSonarQubeURL/setupand follow the setup instructions. - Reanalyze your projects for a better experience.
Upgrading a Docker image instance
To upgrade SonarQube Community Build using the Docker image:
- Stop and remove the existing SonarQube Community Build container:
$ docker stop <container_id>
$ docker rm <container_id>2. Run Docker.
$> docker run -d --name sonarqube \
-p 9000:9000 \
-e SONAR_JDBC_URL=... \
-e SONAR_JDBC_USERNAME=... \
-e SONAR_JDBC_PASSWORD=... \
-v sonarqube_data:/opt/sonarqube/data \
-v sonarqube_extensions:/opt/sonarqube/extensions \
-v sonarqube_logs:/opt/sonarqube/logs \
<image_name> where <image_name> depends on the upgrade target:
- for SonarQube Community Build:
sonarqube - for SonarQube Server Editions: check the tags currently available on the DockerHub page.
3. Go to http://yourSonarQubeURL/setup and follow the setup instructions.
4. Reanalyze your projects for a better experience.
- If you're upgrading with an Oracle database or you're using plugins, you can reuse your extensions volume from the previous version to avoid moving plugins or drivers. Use the Plugin version matrix to ensure that your plugins are compatible with your version. Analysis of all languages provided by your edition is available by default without plugins.
- Unless you intend to delete the database and start new when running your image, be careful not to use
-vtodocker-compose downand, be careful when running commands likedocker system pruneordocker volume prune; regardless if you use anexternal: trueparameter, your database volumes will not persist beyond the initial startup and shutdown of SonarQube Community Build.
Upgrading a Helm chart instance
If you're upgrading with an Oracle database or you're using plugins, you can reuse your extensions Persistent Volume Claims from the previous version to avoid moving plugins or drivers. Use the Plugin Version Matrix to ensure that your plugins are compatible with your version. Analysis of all languages provided by your edition is available by default without plugins.
Please verify that any custom configurations or custom values.yaml files contain only parameters that are still compatible with the targeted chart, and adjust them if needed. Some default values assigned to parameters may have changed between versions of the chart,or other parameters could have been removed.
Standard procedure
- Change the SonarQube Community Build version parameter (
image.tag) on yourvalues.yaml.
Example:image: sonarqube:25.2.0.102705-community - Redeploy SonarQube Community Build with the same helm chart:
helm upgrade --install -f values.yaml -n <yourNamespace> <yourReleaseName> <pathToSonarqubeHelmChart>4. Go to http://yourSonarQubeURL/setup and follow the setup instructions.
5. Reanalyze your projects to get fresh data.
Related pages
Was this page helpful?
© 2008-2025 SonarSource SA. All rights reserved. SONAR, SONARSOURCE, SONARQUBE, and CLEAN AS YOU CODE are trademarks of SonarSource SA.
