Start Free
10.7 | DevOps platform integration | GitLab integration | Importing your GitLab repositories

Importing your GitLab repositories into SonarQube

On this page

Once the integration of SonarQube with GitLab has been properly set up, you can import a GitLab repository to create the corresponding project in SonarQube. To do so, you need the Create Project permission in SonarQube and you must provide a personal access token that authorizes you to access and list your projects in GitLab. 

The so-created SonarQube project is "bound" to its GitLab repository. With a bound project:

  • The project’s main branch name will be automatically set up from GitLab.
  • From the Developer Edition: the quality gate status report to the merge requests will be automatically set up.

Importing one or several GitLab repositories

  1. If it's the first time you import projects, generate a personal access token in GitLab with the read_api scope.
  2. In the top navigation bar of SonarQube, select the Projects tab.
  3. In the top right corner, select the Create Project > Import from DevOps platforms button.
  4. In the Import from GitLab section, select Setup. The GitLab project onboarding page opens. 
  5. If it's the first time you import projects, enter the personal access token generated in the first step in Personal Access Token and save.
    The repositories of the organization are listed on the page.
  6. Select one or several repositories.
  7. Select the Set up button to create the corresponding projects. The Projects page opens and displays the newly created projects at the top.

Importing a GitLab monorepo

See Managing the projects of a monorepo.


Was this page helpful?

© 2008-2024 SonarSource SA. All rights reserved. SONAR, SONARSOURCE, SONARLINT, SONARQUBE, SONARCLOUD, and CLEAN AS YOU CODE are trademarks of SonarSource SA.

Creative Commons License