Skip to main content
Qodo works directly with GitLab, using a dedicated GitLab service account with Developer-level permissions to post code review comments on merge requests. Qodo creates this account automatically using a personal access token you provide during setup, then discards the token. It relies on native merge request workflows to deliver automated insights. You can configure Qodo for selected repositories or across your entire GitLab group. Configuration typically takes around 5–10 minutes. Once installed, Qodo automatically processes merge requests and delivers actionable insights, such as code reviews, descriptions, and improvement suggestions, directly within your GitLab workflow.

​
Prerequisites

Before you begin, ensure you have:
  • Access to your Qodo portal.
  • GitLab group Owner access (GitLab Cloud) or instance Admin access (GitLab Server), to sign in and generate the personal access token during setup.

​
Access the GitLab integration

1
Log in to your Qodo portal.
2
Start the wizard in one of the following ways:
1

From the Integrations page

Navigate to Integrations, then:
  • GitLab Cloud: select the SaaS tab and click Add installation on the GitLab card.
  • GitLab Server: select the Self-Hosted tab and click Add installation on the GitLab card.
2

From the homepage

On the homepage, in the top right-hand side, click the + button next to Git providers. On the selection page, choose GitLab.

​
Install Qodo on GitLab

1

Connect GitLab

GitLab wizard step 1, Connect GitLab, showing the GitLab URL and personal access token fields
1
Enter your GitLab URL:
  • On GitLab Cloud, this defaults to https://gitlab.com. Sign in as a group Owner.
  • On GitLab Server, enter your instance URL (for example, https://gitlab.example.com). Sign in as an instance Admin.
2
Click Create a token in GitLab to open your GitLab instance’s access token settings directly.
  • On GitLab Cloud, this is the only link shown.
  • On GitLab Server, once you enter a non-gitlab.com URL, a second link also appears: Create a token in GitLab 16.6 or earlier. Use it only if your instance is on GitLab 16.6 or earlier; otherwise, use Create a token in GitLab.
The api scope is required and preselected. Leave it selected when you create the token.
This token is used once, to create a dedicated GitLab service account for Qodo, and is never stored, allowing a short expiry, e.g., 1 day. On GitLab Server, this is why the setup token requires instance Admin access: to create that account. The account itself holds Developer-level permissions only, and using a single service account simplifies access and resource management on your GitLab instance. The admin token can be revoked immediately after installation completes.
3
Paste the personal access token and click Next.
2

Select groups and repositories

GitLab wizard step 2, Select groups and repositories, showing the group tree, search bar, and repository checkboxes
1
Find and select what to connect:
  • Use the search bar to find a specific group or repository, or browse the list of top-level groups you have access to.
  • Select a group to connect every repository within it, or drill into a group to select individual repositories.
  • Select Select all to connect everything you have access to in one step.
This step appears as “Select repositories” on GitLab Community Edition and GitLab free-tier instances, which don’t support group hooks, or as “Select groups and repositories” on GitLab tiers that do. When group hooks are available, selecting a group creates a group hook; otherwise, selecting a repository creates a repository hook.
2
Click Next.
3

Install Qodo

GitLab wizard step 3, Install Qodo, showing the confirmation banner and per-group connection status
Qodo confirms it’s connected to your selected repositories and groups.
  • Each one shows its status: Already connected from a previous installation, or Connected if newly connected.
  • On GitLab Cloud, installing across multiple top-level groups sets up each group as a separate installation, appearing as its own item on the Installations tab.
  • Click Done.
Qodo is now active on the repositories in the groups you selected. To connect more repositories under an existing installation, use Manage the repositories in an installation on the Repositories page. To connect a different group, return to this wizard.

​
Verify the installation

1
Open a new merge request in one of the connected repositories and confirm Qodo is triggered automatically.
2
Add a comment using one of the supported commands:
  • /agentic_describe
  • /agentic_review
Qodo should respond with a review or MR summary directly on the merge request.

​
Next steps