Start Free
Latest | DevOps platform integration | GitLab integration | Setting up integration at global level

Setting up the GitLab integration at the global level

On this page

Preparing the integration Setting up the import of GitLab repositories Setting up user provisioning and authentication

This section explains how to set up GitLab and SonarQube Server for global integration. To perform this setup, you need the global Administer System permission in SonarQube Server.

Preparing the integration

Verifying the server base URL

For the GitLab integration to work:

  • The SonarQube Community Build base URL must be a public URL.
  • If you want to delegate the SonarQube Community Build user authentication to GitLab: you must use HTTPS. This means that the SonarQube Community Build must be secured behind a proxy.

You must configure your SonarQube Community Build base URL in SonarQube Community Build, otherwise, integration features will not work correctly.

To verify the server base URL configuration in SonarQube Community Build:

  • Go to Administration > Configuration > General Settings > General > General and check the instance's Server base URL. 
Generating a token

You must provide a GitLab access token that will be used by SonarQube Server to import the repositories and report the quality gate to the merge requests. This token will be stored in SonarQube Server and can be revoked at any time in GitLab.

You can either provide:

  • A personal access token.
    We recommend using a dedicated GitLab account with at least Reporter permissions (the account needs permission to leave comments). Use a personal access token from this account with the api scope authorized for the repositories you're analyzing.
  • Or a Group Access Token with at least the Reporter role and with the api scope. 

If you want to enter the token in SonarQube Server in encrypted format, you can encrypt this token. See Encrypting sensitive settings for more information.

Setting up the import of GitLab repositories

With this setup, users will be able to import GitLab repositories into SonarQube Server.

This integration is performed through a “GitLab Configuration” record, which is used in SonarQube Server to access the GitLab instance. You need the Administration System permission to set up a GitLab Configuration.

To set up a GitLab Configuration in SonarQube Server:

  1. In the SonarQube Server UI, go to Administration > Configuration > General Settings > DevOps Platform Integrations. 
  2. Select the GitLab tab and click Create configuration. The Create a configuration dialog opens.
  3. Specify the following settings:
    • Configuration Name (Enterprise and Data Center Edition only): The name used to identify your GitLab configuration at the project level. Use something succinct and easily recognizable.
    • GitLab URL: The GitLab API URL. We recommend using https://gitlab.com/api/v4. You can also use your own GitLab server URL.
    • Personal Access Token: Token you generated in Preparing the integration above.
  4. Select Save configuration.

Setting up user provisioning and authentication

See GitLab authentication.

Was this page helpful?

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

Creative Commons License