Creating your project
You can create projects on SonarQube Cloud by importing repositories from your DevOps platform.
You can create projects by importing your DevOps platform repositories which automatically binds new projects to the respective repository. This binding has many advantages, see Binding with the DevOps platform for more details. Users will need the Create Projects permission in their organization. You can also create projects manually. However, manually created projects are unbound.
Repository import is only possible if your SonarQube Cloud organization is bound to its corresponding DevOps platform organization (i.e. the DevOps platform organization has been imported to SonarQube Cloud).
By default, the visibility of newly created projects is set to private.
Importing a repository selection
On the top right of the SonarQube Cloud interface, select the ✚ (plus) menu and select Analyze new project. The Analyze projects page opens.
Select your organization.
Select the repositories you want to import. The Set up button shows up.
Select the Set up button. The Setup up new code for project page opens.
Select the new code definition for your project, see Quality standards and new code for more details.
Select the Create project button. The project is created and the Automatic analysis is started if supported.
To import a monorepo, see Monorepo support.
Bulk importing all repositories
This feature is supported for GitHub and GitLab only.
About this feature
You can import all existing repositories from your DevOps Platform organization in a bulk operation.
However, the following repositories will be skipped during the bulk import:
Repositories that have already been imported.
Public repositories, if your SonarQube Cloud organization is configured only for private projects.
Private repositories, if your SonarQube Cloud organization plan does not support private repositories.
When importing from a GitHub organization, the bulk import process will only retrieve and process repositories authorized via the installed SonarQube Cloud app.
You can track the progress of the import using a toast notification that displays the total number of repositories being processed. You have the option to stop the operation at any time; however, stopping the import will not undo the processing of repositories that have already been completed.
Upon completion of the bulk import, a downloadable CSV import report is generated. This file details all processed repositories, indicating their status (Imported, Skipped, or Failed) along with any relevant supplementary information.
Projects created using the bulk import feature are automatically marked as favorite projects. Note that a user has a limit of 100 favorite projects.
Starting and monitoring the import
Ensure your plan grants enough private lines of code (LOC). To change your LOC limit, see Changing the LOC limit of your subscription.
To import all the existing repositories of your GitHub organization:
On the top right of the SonarQube Cloud interface, select the ✚ (plus) menu and select Analyze new project. The Analyze projects page opens.
Select your organization.
In Bulk import all repositories on the right side, select Import all repositories. Note that the button is only available if you don’t select any repository on the left side. The Setup up new code for project page opens.
Select the new code definition for your project, see Quality standards and new code for more details.
Select Create project. The auto-import process begins automatically. You can track its progress using the toast notification, which displays the following metrics:
Processed: The total count and percentage of repositories handled so far.
Imported: The number of repositories successfully added.
Failed: The count of repositories that could not be imported, typically due to issues with the SonarQube Cloud API.
Skipped: The number of repositories excluded because they did not meet the import eligibility criteria. For more information, see About this feature.
In the toast notification, select View projects to view and refresh the list of imported projects.
If you attempt to navigate away from, refresh, or close the current tab, you will be prompted to confirm reloading the site. If confirmed, the import process will stop and the repositories already processed will remain. To remove these imported projects, see Deleting project.
The total number of GitHub repositories to process may not include all of your organization's repositories. This is because only GitHub repositories authorized through the SonarQube Cloud app installed for your organization are eligible for import. To ensure all repositories are authorized for import, you must select All repositories in the Repository Access settings for your GitHub organization. More information can be found in Modifying the repository access rights of the organization. Note that some public repositories may appear on the left side of the Analyze projects page, even if they have not been authorized through the app. These repositories will not be included in the bulk import.
After the import is finished, a completion notification will display. In the notification, select View summary to view the import report. See Viewing the import report below.
Viewing the import report
Upon completion of the bulk import, a downloadable CSV import report is generated. This file details all processed repositories, indicating their status (Imported, Skipped, or Failed) along with any relevant supplementary information.
To view the CSV import report:
In the bulk import complete or incomplete notification, select View summary. The Summary of bulk import opens.
Select the Download CSV list button to download the CSV report.
Stopping the import
To stop the import, select Stop importing in the toast notification and confirm.
The stopping of the import will not remove repositories that have already been processed. To delete imported projects, see Deleting project.
The import proceeds in batches of 25 repositories. Consequently, selecting Stop importing will not halt the process immediately but will allow the currently active batch to complete.
If the import stops on an error
If the import stops on an error, a Bulk import incomplete notification will be displayed. Wait 10 to 15 minutes before attempting to retry the process. You may need to repeat this step if the import continues to fail.
Any repositories that were successfully imported will remain and will not be removed. To view the list of imported repositories, select View summary in the notification. See Viewing the import report for more details.
Auto-import of new repositories
This feature is supported only for GitHub organizations.
If the feature is enabled in your GitHub organization, newly added or created repositories in your GitHub organization are automatically imported into SonarQube Cloud. For more information, see Auto-importing new repositories.
Creating a project manually
On the top right of the SonarQube Cloud interface, select the ✚ (plus) menu and select Analyze new project. The Analyze projects page opens.
On the right of the page, select create a project manually.
Select the organization, enter the project name and key, and set project's visibility.
Click Next.
Select the new code definition for your project, see Quality standards and new code.
Select the Create project button. The project is created. You must now set up your CI-based analysis. Automatic analysis is not supported for unbound projects.
Related pages
Configuring project binding features for your project
Last updated
Was this helpful?