Other migration-related tasks

This article describes how to revert to the previous version of SonarQube Server and how to migrate the database to another vendor.

Reverting to the previous version

If you need to revert to the previous version of SonarQube Server, the high-level rollback procedure for all deployments is as follows:

1. Shut down your SonarQube Server instance or cluster.
2. Roll back your database to the backup you took before starting the upgrade.
3. Switch back to the previous version of your SonarQube Server installation.
4. Start your SonarQube Server instance or cluster.

Migrating the SonarQube Server database to another vendor

To migrate your SonarQube Server database from one database vendor to another, use the Migrating database.

Moving from a ZIP file installation to a Docker installation

To move from a ZIP file installation to a Docker installation:

1. Configure your Docker container to point to your existing database.
2. Shut down your ZIP instance.
3. Installing from the Docker image.

Upgrading a plugin

You need to manually install plugins when using SonarQube Server, you cannot use the SonarQube Marketplace. See Installing a plugin for more information.

Downgrading to SonarQube Community Build

Ensure the target SonarQube Community Build version was released after the source SonarQube Server version. See Releases - Sonar Community for release dates of SonarQube Community Build and SonarQube Server. In most cases, migrating to the latest version of the target product will suffice.

However, if you are using the latest version of SonarQube Server, you may need to wait for the next version of SonarQube Community Build accordingly, typically available within a month.

Once the target version is confirmed, proceed with the standard upgrade procedure.

To upgrade your SonarQube Community Build to SonarQube Server, see Updating from SonarQube Community Build.

Moving between SonarQube Server editions (not Community Build)

If you’re moving to a different SonarQube Server edition (Data Center Edition, Enterprise Edition, or Developer Edition) with the same version, the steps are the same as described in Performing the upgrade without the need to browse to http://yourSonarQubeServerURL/setup or reanalyze your projects.