Setting up your enterprise
This page explains how to set up your SonarQube Cloud Enterprise as part of the Getting started with Enterprise.
With the Enterprise license, you can group together SonarQube Cloud organizations from different DevOps platforms into an enterprise and benefit from many features. Contact our team 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 for more information.
This page explains how to set up your enterprise from scratch. Once you’ve created the enterprise, you become an enterprise Admin automatically.
Currently, Sonar restricts each enterprise to a maximum of 200 organizations.
Step 1: Enter your enterprise details
Log in to SonarQube Cloud with your organization’s administrator account.
Select the + icon in the top right corner of SonarQube Cloud UI and select Create new enterprise in the menu.
In License key, enter the key you received from Sonar.
Enter the name and key of your enterprise.
Select Next.
Step 2: Create or add the organizations
First, you must add your first organization. You can either create a new organization by (a) importing the corresponding DevOps platform organization, (b) create the organization manually or (c) add an existing organization. Once an organization is added to your enterprise, it’s assigned the Enterprise plan.
To import the organization from your DevOps platform, select your DevOps platform service in Import from DevOps platform and follow the instructions. For more information, see:
To add an existing organization, select the organization in Add an existing organization. For more information, see Adding an existing organization.
If you add an existing 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.
At the end of the operation, select Create Enterprise.
The enterprise is created and you’re redirected to your enterprise’s Organizations page. You can now add other organizations to your enterprise. To do so, select Create organization to create a new organization, or Add organization to add an existing organization.
Step 3: Set the enterprise permissions of users
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 page.
To set the enterprise-related permissions of users, follow the instructions to Retrieving and viewing your enterprise. Once inside of your enterprise:
Navigate to Administration > Enterprise Permissions.
Filter the list by Admins or Creators, or search for specific users.
For each user, toggle the Administer Enterprise and Create Portfolios permissions.
Step 4: Complete the enterprise onboarding
For each organization in your enterprise:
If not already done, verify the group's default permissions on new projects. See the Using permission templates page for more information.
You can set project configurations at the organization level. The details are outlined in the Performing global analysis setup 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 page.
With the Enterprise license, you can now set up enterprise security features. For more information, see Enterprise security.
Step 5: Prepare developer IDE access
After the enterprise is created and organizations are attached, plan how developers will install SonarQube for IDE and bind their projects in SonarQube for IDE. Connected mode applies your SonarQube Cloud quality profiles, rule selections, file exclusions, and issue states in the IDE.
SonarQube for IDE is available for VS Code, IntelliJ, Visual Studio, and Eclipse. If your organization manages VS Code extensions through a VS Code Private Marketplace, add SonarQube for VS Code to the private catalog before developer onboarding.
Related pages
Related online learning
Last updated
Was this helpful?