> For the complete documentation index, see [llms.txt](https://docs.sonarsource.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sonarsource.com/sonarqube-server/2025.3/devops-platform-integration/gitlab-integration/importing-repos.md).

# Importing your GitLab repositories

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 Server. To do so, you need the Create Project permission in SonarQube Server.

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. In the top navigation bar of SonarQube Server, select the **Projects** tab.
2. In the top right corner, select the **Create Project** > **Import from DevOps platforms** button.
3. In the **Import from GitLab** section, select **Setup**. The **GitLab project onboarding** page opens.\
   The repositories of the organization are listed on the page.
4. Select one or several repositories.
5. 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>

Starting in [Enterprise Edition](https://www.sonarsource.com/plans-and-pricing/enterprise/), you can import a GitLab monorepo. See [Managing monorepo projects](/sonarqube-server/2025.3/project-administration/monorepos.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.