Start FreeLog in
SonarQube Cloud | Administering SonarQube Cloud | Managing organizations

Managing your organizations

On this page

Setting up an organization Importing an organization Creating an organization manually Allowing only private projects in an organization Binding an unbound organization Changing the organization key Deleting an organization Related pages

This section explains how to manage SonarQube Cloud organizations. It's directed at the organization admins.

Setting up an organization

The procedure below explains how to set up an organization when your system uses DOP (DevOps platform) authentication. For SAML SSO authentication, see Onboarding a new organization on a SAML-SSO-enabled enterprise.

  1. Sign up for SonarQube Cloud by using your DevOps platform account. 
  2. Import your DevOps platform organization: see Importing an organization below. The corresponding SonarQube Cloud organization is automatically created, and you’re granted the Administer permission on it.
  3. Set project configurations at the organization level.
  4. Invite your DevOps platform organization users to sign up for SonarQube Cloud. Their SonarQube Cloud account will be automatically created.
  5. If you use a GitHub platform with automatic member synchronization, the organization members are automatically synchronized in SonarQube Cloud. Otherwise, you must add the SonarQube Cloud users to your organization manually.
  6. Manage the permissions of the users and groups. In particular:
  7. Authorized organization members can now create projects.

Importing an organization

You create a SonarQube Cloud organization by importing the corresponding DevOps platform organization. The so-created organization is bound to the DevOps platform organization. Your user account is automatically assigned to the organization’s Owners group which grants you administration rights on the organization. 

Currently, the following apply (The limitations on GitHub and Bitbucket organization import will be removed in a next SonarQube Cloud release.):

  • To import a GitHub organization, you must log in to SonarQube Cloud with your GitHub account.
  • To import a Bitbucket organization, you must log in to SonarQube Cloud with your Bitbucket account.
  • To import a GitLab or Azure DevOps organization, you can use any account, including your SAML SSO account. 

To import a DevOps platform organization:

  1. On the top right of the SonarQube Cloud interface, select the ✚ (plus) menu and select Create new organization. The Create an organization page opens.
  2. Select the Import button corresponding to the DevOps platform. Follow the instructions. See Set up your organization on the corresponding page:

Creating an organization manually

You may also create your organization manually (without importing the DevOps platform organization). But in that case, you will not benefit from the advantages of a bound organization.

To create an organization manually:

  1. On the top right of the SonarQube Cloud interface, select the ✚ (plus) menu and select Create new organization. The Create an organization page opens.
  2. Select the create one manually hyperlink below the Import button.
  3. Enter the organization name and key.
  4. Select the subscription plan and follow the instructions.
  5. Select the Create organization button.

Allowing only private projects in an organization

In a Team or Enterprise plan organization, you can restrict project creation to private projects only. If public projects belong to the organization, you must make them private first: see Changing the project's visibility.

To allow only private projects in your organization:

  1. Retrieve the organization.
  2. Go to Administration > Organization settings > Only allow private projects.
  3. Select the Only allow private projects checkbox.
  4. Select Save. 

Binding an unbound organization

If you created your organization manually, then it’s not bound to its corresponding DevOps platform organization and you don’t benefit from many advantages. This procedure explains how to bind your unbound organization. To do so, you need the corresponding permissions on your DevOps platform.

Currently, the following apply (The limitations on GitHub and Bitbucket organization binding will be removed in a next SonarQube Cloud release.):

  • To bind a GitHub organization, you must log in to SonarQube Cloud with your GitHub account.
  • To bind a Bitbucket organization, you must log in to SonarQube Cloud with your Bitbucket account.
  • To bind a GitLab or Azure DevOps organization, you can use any account, including your SAML SSO account. 

To bind your unbound organization:

  1. Retrieve the organization.
  2. Go to Administration > Organization settings  > Organization Binding.
  3. Select the button corresponding to the DevOps platform. The integration page opens in the DevOps platform.
  4. Bind the organization. See:

Changing the organization key

The organization key is set when you import the organization into SonarQube Cloud. At that point, you can choose your own key or accept the suggested key. In some cases, you may later wish to change this key (for example, if a new naming convention is adopted at your company, or if you initially chose a bad key by accident).

To change the key of your organization:

  1. Retrieve the organization.
  2. Go to Administration > Organization settings  >  Edit organization key.
  3. In Key, enter your new key, and select Save.
  4. Make the same change to the sonar.organization setting of every project in the organization that is configured for CI-based analysis, or inform the respective project administrators.

Deleting an organization

You can delete an organization provided you’re an organization admin.  

From your account's Organizations page
  1. Select your account menu in the top right corner of the SonarQube Cloud interface.
  2. In the menu, select My Organizations.  Your account's Organizations page opens.
  3. Select Delete on the row of the organization you want to delete.
From the organization record
  1. Retrieve the organization (see Retrieving and viewing your organizations above).
  2. Go to Administration > Organization settings. 
  3. In the Delete Organization section, select the Delete button. The Delete organization dialog opens.
  4. Enter your organization name and select Delete.

Was this page helpful?

© 2008-2024 SonarSource SA. All rights reserved. SONAR, SONARSOURCE, SONARQUBE, and CLEAN AS YOU CODE are trademarks of SonarSource SA.

Creative Commons License