# Setting up your enterprise

With the Enterprise license, you can group together SonarQube Cloud organizations from different DevOps platforms into an enterprise and benefit from many features.

This page explains how to set up your enterprise from scratch.

{% hint style="info" %}
Currently, Sonar restricts each enterprise to a maximum of 200 organizations.
{% endhint %}

## Step 1: Prepare the enterprise onboarding <a href="#prepare-onboarding" id="prepare-onboarding"></a>

### Prepare the organizations to be added <a href="#prepare-the-organizations-to-be-added" id="prepare-the-organizations-to-be-added"></a>

You must add at least one organization to be able to complete your enterprise setup. You can add any existing organization that is under your administration. Once an organization is added to your enterprise, it’s assigned the Enterprise plan.

{% hint style="warning" %}
If you add a Team plan organization to your enterprise, the organization’s Team plan subscription will be automatically cancelled and the organization will be moved to the Enterprise plan without a refund. Therefore, we recommend adding your organizations before their next billing date to avoid double charges.
{% endhint %}

To create a new organization to be added to your enterprise, import the DevOps platform organization and select the Free plan. For instructions to import your DevOps organization, please see:

* [importing-github-organization](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-organization/creating-organization/importing-github-organization "mention")
* [importing-gitlab-group](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-organization/creating-organization/importing-gitlab-group "mention")
* [importing-bitbucket-workspace](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-organization/creating-organization/importing-bitbucket-workspace "mention")
* [importing-azure-devops-organization](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-organization/creating-organization/importing-azure-devops-organization "mention")

### Request a license <a href="#request-a-license" id="request-a-license"></a>

[Contact our team](https://www.sonarsource.com/products/sonarcloud/contact-enterprise-sales/) to request an Enterprise license. Provide the maximum number of Lines of Code (LOC) you want to have in your enterprise. For more information, see [#loc-based-pricing](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-subscription/subscription-plans#loc-based-pricing "mention") for more information.

## Step 2: Create the SonarQube Cloud enterprise <a href="#create-enterprise" id="create-enterprise"></a>

You must be an Admin of the organization you wish to add to the enterprise. Once you’ve created the enterprise, you become an Enterprise Admin automatically.

To create your enterprise:

1. Log in to SonarQube Cloud with your organization’s administrator account.
2. Select the **+** icon in the top right corner of SonarQube Cloud UI and select **Create new enterprise** in the menu.

<div align="left"><figure><img src="https://2223713658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB4UT2GNiZKjtxFtcFAL7%2Fuploads%2FYiYl7dXTVI6tGfWuqAVc%2Fenterprise-create.png?alt=media&#x26;token=9d2b073e-874b-45a2-9bf1-252f1cd696d6" alt="Create an enterprise"><figcaption></figcaption></figure></div>

3. In **License key**, enter the key you received from Sonar
4. Enter the name and key of your enterprise.
5. In **Add organization**, select the first organization to be added to your enterprise to complete the setup.

6\. Select the **Create enterprise** button. The enterprise is created.

## Step 3: Set the enterprise permissions of users <a href="#set-permissions" id="set-permissions"></a>

As an Enterprise Admin, you can grant the Administer Enterprise and Create Portfolios permissions. For more information, check out the [managing-the-enterprise-related-permissions](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-enterprise/managing-the-enterprise-related-permissions "mention") page.

To set the enterprise-related permissions of users, follow the instructions to [retrieving-and-viewing-your-enterprise](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-enterprise/retrieving-and-viewing-your-enterprise "mention"). Once inside of your enterprise:

1. Navigate to **Administration** > **Enterprise Permissions**.
2. Filter the list by **Admins or Creators**, or search for specific users.
3. For each user, toggle the **Administer Enterprise** and **Create Portfolios** permissions.

<div align="left"><figure><img src="https://2223713658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB4UT2GNiZKjtxFtcFAL7%2Fuploads%2FLGHyDnETA204a8qCXrvY%2Fenterprise-permissions.png?alt=media&#x26;token=4f2ffa23-3cde-4c55-827c-22ec8ff9005f" alt="Enterprise permissions"><figcaption></figcaption></figure></div>

## Step 4: Complete the enterprise onboarding <a href="#complete-onboarding" id="complete-onboarding"></a>

For each organization in your enterprise:

* If not already done, verify the group's default permissions on new projects. See the [templates](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-organization/manage-org-projects/manage-project-permissions/templates "mention") page for more information.
* You can set project configurations at the organization level. The details are outlined in the [setting-config-at-org-level](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-organization/setting-config-at-org-level "mention") pages.

By default, all organizations share the enterprise LOC limit. You can allocate an individual LOC limit to one or several organizations within your enterprise; please check the [managing-the-lines-of-code-within-your-enterprise](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-enterprise/managing-the-lines-of-code-within-your-enterprise "mention") page.

With the Enterprise license, you can now set up enterprise security features. For more information, see [enterprise-security](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/enterprise-security "mention").

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

* [viewing-billing-usage-info](https://docs.sonarsource.com/sonarqube-cloud/getting-started-with-enterprise/viewing-billing-usage-info "mention")
* [adding-organizations-to-your-enterprise](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-enterprise/adding-organizations-to-your-enterprise "mention")
* [onboarding-new-org](https://docs.sonarsource.com/sonarqube-cloud/getting-started-with-enterprise/onboarding-new-org "mention")
* [recovering-enterprise-admin-access](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-enterprise/recovering-enterprise-admin-access "mention")

## Related online learning

* <i class="fa-desktop">:desktop:</i> [Initial SonarQube Cloud Enterprise set up](https://www.sonarsource.com/learn/course/sonarqube-cloud/e390f0fe-64f4-4840-b74c-e63598af72f2/initial-sonarqube-cloud-enterprise-set-up)