SonarCloud | Administering your SonarCloud | Managing organizations

Managing your organizations

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.

Sign up for SonarCloud by using your DevOps platform account.
Import your DevOps platform organization: see Importing a DevOps platform organization under Onboarding your organization below. The corresponding SonarCloud organization is automatically created, and you’re granted the Administer permission on it.
Set project configurations at the organization level.
Invite your DevOps platform organization users to sign up for SonarCloud. Their SonarCloud account will be automatically created.
If you use a GitHub platform with automatic member synchronization, the organization members are automatically synchronized in SonarCloud. Otherwise, you must add the SonarCloud users to your organization manually.
Manage the permissions of the users and groups. In particular:
- Create the user groups in your organization.
- Define the users and groups that can create projects in the organization.
- Verify the default permissions on new projects.
Authorized organization members can now create projects.

Onboarding an organization

You create a SonarCloud organization by importing the corresponding DevOps platform organization. The so-created organization is bound to the DevOps platform organization.

When you import an organization, and this organization has only private repositories, you’ll have to purchase first the Team plan subscription for this organization.
It means that if you want to assign the Enterprise plan to this organization, you’ll need to do it in a second step: for more information, see Managing your organization's subscription. Otherwise, you can create a manual organization first (see below), upgrade it to the Enterprise plan, and then bind it to the DevOps repository (see below).

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.

You cannot unbind nor change the binding of a bound organization.
You currently cannot import an organization with a SAML SSO account.

Importing a DevOps platform organization

On the top right of the SonarCloud interface, select the ✚ (plus) menu and select Create new organization. The Create an organization page opens.
Select the Import button corresponding to your DevOps platform. See:

Creating an organization manually

On the top right of the SonarCloud interface, select the ✚ (plus) menu and select Create new organization. The Create an organization page opens.
Select the create one manually hyperlink below the Import button.
Enter the organization name and key.
Select the subscription plan.
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:

Retrieve the organization.
Go to Administration > Organization settings > Only allow private projects.
Select the Only allow private projects checkbox.
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.

You currently cannot bind an organization with a SAML SSO account.

To bind your unbound organization:

Retrieve the organization.
Go to Administration > Organization settings > Bind this organization.
Select the Choose the organization on <DevOps platform> button. The integration page opens in your DevOps platform.
Follow the instructions.

You cannot unbind nor change the binding of a bound organization.

Changing the organization key

The organization key is set when you import the organization into SonarCloud. 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).

The organization key is used in CI-based analysis setups to link the analysis produced by the scanner in your local or cloud-based build environment with the correct organization in SonarCloud. It appears as the value of the sonar.organization parameter in your analysis configuration.

To change the key of your organization:

Retrieve the organization..
Go to Administration > Organization settings > Edit organization key.
In Key, enter your new key, and select Save.
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

Select your account menu in the top right corner of the SonarCloud interface.
In the menu, select My Organizations. Your account's Organizations page opens.
Select Delete on the row of the organization you want to delete.

From the organization record

Retrieve the organization (see Retrieving and viewing your organizations above).
Go to Administration > Organization settings.
In the Delete Organization section, select the Delete button. The Delete organization dialog opens.
Enter your organization name and select Delete.

Was this page helpful?