Changing project binding

This page is directed at the project admin and explains how to change the binding or key of your SonarQube Cloud project.

Changing the binding of your project

You can bind a project to another repository or you can bind an unbound project to a repository. See Binding with the DevOps platform for more information.

Binding a project to another repository

You can change the repository binding of a project provided you have Administer permission on that project and Create projects permission. The following limitations apply:

  • The source and target repositories must be in the same organization.

  • A public project cannot be bound to a private repository.

The repository change will not impact the automatic analysis activation status of your project except if the target repository is a monorepo and automatic analysis was enabled for your project. In that case, the automatic analysis will be disabled since it’s not supported for monorepos and you will need to manually configure a CI-based analysis for your project. See Overview of integrated CIs for more details.

To bind a project to another repository:

  1. Retrieve your project. See Retrieving projects for more details.

  2. Go to Administration > General Settings > Repository binding.

  3. In the list of repositories, select the target repository and select Save.

Binding an unbound project to a repository

You can bind an unbound project to a repository provided you have Administer permission on that project and Create project permission. Note that a public project cannot be bound to a private repository.

In case you had manually linked your project to a repository, you should remove this manual setup.

To bind an unbound project to a repository:

  1. Retrieve your project. See Retrieving projects for more details.

  2. Go to Administration > General Settings > Repository binding.

  3. In the list of repositories, select the repository and select Save.

You may want to enable the automatic analysis on your newly bound project. To do so, see Activating automatic analysis.

Updating the project binding on repository URL change

In case you renamed your repository or moved it within the same organization, you can update the repository binding to your SonarQube Cloud project as follows:

  1. Retrieve your project. See Retrieving projects for more details.

  2. Go to Administration > General Settings > Repository binding.

  3. In the list of repositories, re-select the target repository and select Save.

Changing the project key

  1. Retrieve your project. See Retrieving projects for more information.

  2. In the left sidebar, select Administration > Update Key. The Update Key page opens.

  3. Enter the new key and select Update.

Last updated

Was this helpful?