Changing the binding of your organization

Sonar is planning to change the organization binding feature in order to allow a simplified change of organization binding. In the meantime, you can use the workaround described below for a SonarQube Cloud organization bound to a GitHub organization or a Bitbucket workspace.

You will first unbind the SonarQube Cloud organization and then rebind it to the new DevOps platform organization. The new organization may be on any DevOps platform (GitHub, Bitbucket, GitLab or Azure DevOps). 

The operation is different if the new binding is on a different DevOps platform.

Prerequisites

To be able to change the binding of a SonarQube Cloud organization, you must:

• Be an admin of the organization.
• Have the required permissions on the new DevOps platform organization. It means, depending on the DevOps platform:
  • GitHub: be an owner of the GitHub organization.
  • Bitbucket workspace: be an administrator of the Bitbucket workspace. You will already be an administrator of your default workspace. For any other workspace, you have to add your Bitbucket account to a user group with the Administer workspace user right enabled.
  • GitLab: be an owner of the GitLab group.
  • Azure DevOps: be an administrator of the Azure DevOps organization.

On the same DevOps platform

1. Remove the SonarQube Cloud app from the GitHub organization or a Bitbucket workspace (this will unbind the organization in SonarQube Cloud). See:
   • Deleting a GitHub App in the GitHub documentation.
   • Removing an app in the Altassian documentation.
2. Sign in to SonarQube Cloud. 
3. Bind the unbound organization to the new DevOps platform organization. See Binding an unbound organization.
4. Change the binding of each project in the SonarQube Cloud organization. See Changing the project binding.

On a different DevOps platform

This section explains the operation in case you want to change the binding of the organization to a different DevOps platform. DevOps platform1 refers to your GitHub organization or Bitbucket workspace that you want to unbind. DevOps platform2 refers to your GitHub organization, Bitbucket workspace, GitLab group, or Azure DevOps organization that you want to bind to.

If you're a member of an enterprise and DevOps platform2 is not Bitbucket, you may use any of your DevOps Platform accounts or your SSO account to perform the new binding. It means that you can log in to SonarQube Cloud with your account that is an admin of the SonarQube Cloud organization and follow the steps above in On the same DevOps platform.

Otherwise, you must use your DevOps platform2's account (Account2) to perform the new binding. You must make sure that Account2 is also an admin of the SonarQube Cloud organization to be changed. If it's not the case, you must add it to the organization by using your DevOps platform1's account (Account1) that is an admin of the organization. To do so:

1. Sign in to SonarQube Cloud with Account1.
2. Add Account2 as a member of the SonarQube Cloud organization: see Adding organization members. This operation is not possible if Account1 and Account2 have different email addresses, since SonarQube Cloud doesn’t simultaneously support two accounts with the same email address. In that case, another user must perform the procedure and you must first set this user as an admin of the organization.
3. Grant the Administer organization permission to Account2: see Managing organization permissions.
4. You can now follow the steps above in On the same DevOps platform by signing in to SonarQube Cloud with Account2.