Overview

The article lists the steps you have to perform to update your SonarQube Server installation.

If you previously used ZIP installation, we recommend installing SonarQube Server from a Docker image or Helm chart (Kubernetes/OpenShift). These methods make it easier to update to newer versions and to operate your instance. Install from the ZIP file only if neither of those options is feasible for your environment.

Reasons to upgrade immediately

In SonarQube Server, you need to perform an upgrade in the following situations:

1. If you are on a version of SonarQube Server that is no longer active.

2. If you are on the latest version of SonarQube Server and there is a new upgrade available.

3. If you are on the latest version or Long-Term-Active (LTA) for which there is a new patch version available (security and bug fixes).

Upgrade steps

Follow these steps to perform an upgrade of your SonarQube Server:

1. Read Release cycle model.

2. Determining the upgrade path.

3. Read the Upgrade notes between the SonarQube versions.

4. Pre-upgrade steps.

5. Back up the SonarQube Server database.

6. Performing the upgrade.

7. Post-upgrade steps.

Related pages

• Updating from SonarQube Community Build

• Moving to another SonarQube Server edition

• Other migration-related tasks