Skip to main content
Using GitLab Server? The installation flow is the same as Qodo single-tenant. See Qodo single-tenant.
Not sure which deployment model you need? See Install Qodo in your Git provider for a full comparison, or check your deployment type.
Qodo works directly with GitLab Cloud, using a dedicated GitLab account to post code review comments on merge requests. It relies on GitLab OAuth and 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 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.
  • System administrator access to your GitLab group.
  • A dedicated email address to use as a Qodo GitLab account (for example, qodo@yourcompany.com). The account is created during the installation wizard.

​
Access the GitLab integration

1
Log in to your Qodo portal.
2
From the left-hand navigation menu, select Integrations.
3
Select the SaaS tab, locate the GitLab card, and click Add installation to launch the installation wizard.

​
Install Qodo on GitLab Cloud

1

Before you begin

GitLab wizard step 1 showing Before you begin screen with instruction to create a dedicated Qodo email address
1
Create a dedicated Qodo email address in your company domain (for example, qodo@yourcompany.com) to use as the Qodo GitLab account. You may need to contact your IT team to provision the user account.
2
Click Next.
2

Add Qodo to GitLab

Using the email you just created, add Qodo as a user in your GitLab workspace.
  • Click Download Qodo logo for avatar and save it for use in sub-step 3.
Complete the following steps in GitLab:
1

Invite the Qodo user

In your GitLab group, go to Manage → Members and click Invite members. In the dialog, enter the Qodo email address, set the role to Maintainer, and click Invite.
GitLab wizard step 2 showing Invite members dialog with Qodo user email and Maintainer role highlighted
2

Create the Qodo GitLab account

The invited user receives an email from GitLab. Accept the invitation and complete the account setup.
The GitLab first name must be set as Qodo.
GitLab wizard step 2 showing Get started with GitLab signup form with First name set to Qodo highlighted
3

Add the public avatar

In the Qodo account’s GitLab profile settings, go to Edit Profile and upload the Qodo logo as the public avatar.
GitLab wizard step 2 showing GitLab profile settings with Public avatar upload option
Back in the wizard, select the Confirm GitLab Qodo account creation checkbox, then click Next.
3

Install Qodo

1
Enter your GitLab Organization URL (for example, https://gitlab.com/yourgroup) and click Install Qodo. You are redirected to GitLab to authorize access.
GitLab wizard step 3 showing Install Qodo screen with GitLab Organization URL field and maintainer requirement notes
2
Review the requested permissions and click Authorize Qodo-code-review. You are redirected back to the wizard automatically.
GitLab OAuth authorization dialog for Qodo-code-review requesting access to account on GitLab.com
4

Select repositories

1
Select the repositories where you want to enable Qodo. Use the search bar to find specific repositories, or browse the group tree.
GitLab wizard step 4 showing Select repositories screen with group tree and checkboxes
2
Click Setup to continue.
5

Check connection

GitLab wizard step 5 showing Check connection with GitLab installation is successful confirmation
Qodo automatically verifies the connection to your selected repositories. Once verification is complete, a confirmation is displayed.
  • Click Next to proceed.
If the connection fails, click Retry. If it still fails, contact your Qodo Account Manager.
6

Installation complete

GitLab wizard step 6 showing Installation complete with connected repository count and enabled capabilities
The confirmation screen shows the number of connected repositories and confirms that AI code review, auto rule generation, and codebase context are active.
  • Click Done.
Qodo is now active on the selected repositories. To add repositories, return to this wizard at any time and run a new installation with the updated scope. Repositories that already have Qodo installed are not available for selection. To reduce scope, remove the installation and create a new one.

​
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