# Importing your GitLab repositories

Once the integration of SonarQube Server with GitLab has been properly [global-setup](https://docs.sonarsource.com/sonarqube-server/10.8/devops-platform-integration/gitlab-integration/global-setup "mention"), you can import a GitLab repository to create the corresponding project in SonarQube Server. To do so, you need the Create Project permission in SonarQube Server and you must provide a personal access token that authorizes you to access and list your projects in GitLab.

The so-created SonarQube Server 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](https://www.sonarsource.com/plans-and-pricing/developer/): the quality gate status report to the merge requests will be automatically set up.

## Importing one or several GitLab repositories <a href="#one-or-several" id="one-or-several"></a>

1. If it’s the first time you import projects, generate a [personal access token](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html#create-a-personal-access-token) in GitLab with the `read_api` scope.
2. In the top navigation bar of SonarQube Server, 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 <a href="#monorepo" id="monorepo"></a>

See [monorepos](https://docs.sonarsource.com/sonarqube-server/10.8/project-administration/monorepos "mention").


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sonarsource.com/sonarqube-server/10.8/devops-platform-integration/gitlab-integration/importing-repos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.