Managing your organizations
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.
- Sign up for SonarQube Cloud by using your DevOps platform account.
- 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.
- Set project configurations at the organization level.
- Invite your DevOps platform organization users to sign up for SonarQube Cloud. Their SonarQube Cloud account will be automatically created.
- 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.
- 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 SonarQube Cloud 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.
Importing a DevOps platform organization
To import a DevOps platform organization:
- On the top right of the SonarQube Cloud interface, select the ✚ (plus) menu and select Create new organization. The Create an organization page opens.
- Select the Import button corresponding to the DevOps platform. Follow the instructions. See:
Creating an organization manually
- On the top right of the SonarQube Cloud 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 and follow the instructions.
- 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 button corresponding to the DevOps platform. The integration page opens in the DevOps platform.
- Bind the organization. See:
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 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).
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 SonarQube Cloud. 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 SonarQube Cloud 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.
Related pages
- Managing the organization members and the organization-related permissions
- Managing the user groups in your organization
- Managing the organization's subscription
- Managing the projects of your organization:
- Setting project configurations at the organization level
- Advanced administration of your organization
Was this page helpful?