Importing your GitLab repositories

Importing a GitLab repository to create a corresponding project in SonarQube Community Build.

Once the integration of your SonarQube instance 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 Server.

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.

Step 1: Create a Personal Access Token

You must provide a GitLab Personal Access Token with read_api scope. This token will be stored in SonarQube and can be revoked at any time in GitLab. SonarQube will use this token to access and list your GitLab repositories. Copy it (you will have to paste it during Step 2). You may ask your administrator to encrypt this token.

Step 2: Import one or several GitLab repositories

1. In the top navigation bar of SonarQube Server, select the Projects tab.

2. In the top right corner, select Create Project > From GitLab.The GitLab project onboarding page opens.

3. In Personal Access Token, enter the PAT you created in Step 1 and select Save. The repositories to which the PAT has access are listed on the page.

4. Select one or several repositories to be imported and follow the instructions.

Related pages

Setting up GitHub integration at global level