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

Managing your organizations

On this page

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 a DevOps platform organization under Onboarding your 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.

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

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.

When you create an organization with a DOP user account, your user account is automatically assigned to the organization’s Owners group which grants you administration rights on the organization. 

Importing a DevOps platform organization

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

To bind your unbound organization:

  1. Retrieve the organization.
  2. Go to Administration > Organization settings  > Bind this organization
  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