# 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](/sonarqube-cloud/administering-sonarcloud/managing-organization/creating-organization/importing-github-organization.md)
* [Importing GitLab group](/sonarqube-cloud/administering-sonarcloud/managing-organization/creating-organization/importing-gitlab-group.md)
* [Importing Bitbucket workspace](/sonarqube-cloud/administering-sonarcloud/managing-organization/creating-organization/importing-bitbucket-workspace.md)
* [Importing Azure DevOps organization](/sonarqube-cloud/administering-sonarcloud/managing-organization/creating-organization/importing-azure-devops-organization.md)

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

[Contact our team](https://www.sonarsource.com/products/sonarqube/cloud/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 [Subscription plans](/sonarqube-cloud/administering-sonarcloud/managing-subscription/subscription-plans.md#loc-based-pricing) 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="/files/36kfi5MKV23ydZ64i6nB" 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](/sonarqube-cloud/administering-sonarcloud/managing-enterprise/managing-the-enterprise-related-permissions.md) page.

To set the enterprise-related permissions of users, follow the instructions to [Retrieving and viewing your enterprise](/sonarqube-cloud/administering-sonarcloud/managing-enterprise/retrieving-and-viewing-your-enterprise.md). 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="/files/Y7BknpTvFMtngmrWevjC" 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 [Using permission templates](/sonarqube-cloud/administering-sonarcloud/managing-organization/manage-org-projects/manage-project-permissions/templates.md) page for more information.
* You can set project configurations at the organization level. The details are outlined in the [Performing global analysis setup](/sonarqube-cloud/administering-sonarcloud/managing-organization/setting-config-at-org-level.md) 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](/sonarqube-cloud/administering-sonarcloud/managing-enterprise/managing-the-lines-of-code-within-your-enterprise.md) page.

With the Enterprise license, you can now set up enterprise security features. For more information, see [Enterprise security](/sonarqube-cloud/administering-sonarcloud/enterprise-security.md).

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

* [Viewing usage information](/sonarqube-cloud/getting-started-with-enterprise/viewing-billing-usage-info.md)
* [Adding organizations to your enterprise](/sonarqube-cloud/administering-sonarcloud/managing-enterprise/adding-organizations-to-your-enterprise.md)
* [Onboarding a new organization](/sonarqube-cloud/getting-started-with-enterprise/onboarding-new-org.md)
* [Recovering enterprise admin access](/sonarqube-cloud/administering-sonarcloud/managing-enterprise/recovering-enterprise-admin-access.md)
* [Permissions](/sonarqube-cloud/administering-sonarcloud/permissions.md)

## 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)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sonarsource.com/sonarqube-cloud/getting-started-with-enterprise/setting-up-your-enterprise.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
