Other migration-related tasks

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 SonarQube DB Copy Tool.

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. Start your Docker container.

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. 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.