# Onboarding a new organization

To perform this procedure, you must be an admin of your enterprise. The procedure is different if the enterprise is SSO-enabled or not.

## Without SSO <a href="#without-sso" id="without-sso"></a>

1. Create your organization in SonarQube Cloud by importing the DevOps platform organization and select the Free plan. See:
   * [importing-github-organization](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/administering-sonarcloud/managing-organization/creating-organization/importing-github-organization "mention")
   * [importing-bitbucket-workspace](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/administering-sonarcloud/managing-organization/creating-organization/importing-bitbucket-workspace "mention")
   * [importing-gitlab-group](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/administering-sonarcloud/managing-organization/creating-organization/importing-gitlab-group "mention")
   * [importing-azure-devops-organization](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/administering-sonarcloud/managing-organization/creating-organization/importing-azure-devops-organization "mention")
2. Add the organization to the enterprise:
   * Retrieve your enterprise. See [retrieving-and-viewing-your-enterprise](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/administering-sonarcloud/managing-enterprise/retrieving-and-viewing-your-enterprise "mention") for more details.
   * Go to **Administration** > **Organizations** and select **Add organization**.

<figure><img src="https://2223713658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB4UT2GNiZKjtxFtcFAL7%2Fuploads%2F1hYWA1yEipVD033HwsIz%2Fenterprise-add-organization.png?alt=media&#x26;token=caec6cf8-c61d-4700-b375-a0f273072f58" alt="Add an organization to your enterprise"><figcaption></figcaption></figure>

3. Optionally, allocate an individual LOC limit to the organization. See [#allocating-loc-limit](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/administering-sonarcloud/managing-enterprise/managing-the-lines-of-code-within-your-enterprise#allocating-loc-limit "mention").
4. Create the organization's user groups. See [user-groups](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/administering-sonarcloud/managing-organization/users-and-permissions/user-groups "mention") for more details. \
   You can also add individual users to the organization. See [organization-members](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/administering-sonarcloud/managing-organization/users-and-permissions/organization-members "mention").
5. Manage the permissions:
   * Define the users and/or groups that can create projects in the organization. See [organization-permissions](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/administering-sonarcloud/managing-organization/users-and-permissions/organization-permissions "mention") for more information.
   * Verify the default permissions on new projects. See [templates](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/administering-sonarcloud/managing-organization/manage-org-projects/manage-project-permissions/templates "mention") for more details.
6. Set analysis configurations at the organization level. See [setting-config-at-org-level](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/administering-sonarcloud/managing-organization/setting-config-at-org-level "mention").
7. Authorized organization members can now create projects or portfolios.

## With SSO and SCIM <a href="#with-sso" id="with-sso"></a>

The procedure below explains how to onboard a new organization on an SSO-enabled enterprise with SCIM provisioning.

1. Create your organization in SonarQube Cloud by importing the DevOps platform organization and select the Free plan. See:
   * [importing-github-organization](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/administering-sonarcloud/managing-organization/creating-organization/importing-github-organization "mention")
   * [importing-bitbucket-workspace](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/administering-sonarcloud/managing-organization/creating-organization/importing-bitbucket-workspace "mention")
   * [importing-gitlab-group](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/administering-sonarcloud/managing-organization/creating-organization/importing-gitlab-group "mention")
   * [importing-azure-devops-organization](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/administering-sonarcloud/managing-organization/creating-organization/importing-azure-devops-organization "mention")
2. Add the organization to the enterprise:
   * Retrieve your enterprise. See [retrieving-and-viewing-your-enterprise](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/administering-sonarcloud/managing-enterprise/retrieving-and-viewing-your-enterprise "mention") for more details.
   * Go to **Administration** > **Organizations** and select **Add organization**.
3. Optionally, allocate an individual LOC limit to the organization. See [#allocating-loc-limit](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/administering-sonarcloud/managing-enterprise/managing-the-lines-of-code-within-your-enterprise#allocating-loc-limit "mention").
4. Map the SCIM groups to the new organization. See [map-groups](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/administering-sonarcloud/enterprise-security/sso-and-provisioning/setup/map-groups "mention").&#x20;
5. Complete and terminate the SSO and provisioning setup. See [complete-setup](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/administering-sonarcloud/enterprise-security/sso-and-provisioning/setup/complete-setup "mention").
6. Set analysis configurations at the organization level. See [setting-config-at-org-level](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/administering-sonarcloud/managing-organization/setting-config-at-org-level "mention").
7. Authorized organization members can now create projects or portfolios.

## Related pages <a href="#related-pages" id="related-pages"></a>

* [setting-up-your-enterprise](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/getting-started-with-enterprise/setting-up-your-enterprise "mention")\
  View the different steps necessary to create and configure an enterprise.
* [viewing-billing-usage-info](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/getting-started-with-enterprise/viewing-billing-usage-info "mention")
* [managing-enterprise](https://docs.sonarsource.com/sonarqube-cloud/~/changes/1027/administering-sonarcloud/managing-enterprise "mention")