> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qodo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Qodo on GitLab Cloud - Multi-tenant

> Multi-tenant GitLab Cloud install guide for Qodo automated code review.

<Note>
  Using GitLab Server? The installation flow is the same as Qodo single-tenant. See [Qodo single-tenant](/install-and-configure/install/gitlab/qodo-single-tenant).
</Note>

<Note>
  Not sure which deployment model you need? See [Install Qodo in your Git provider](/install-and-configure/install) for a full comparison, or [check your deployment type](/deployment-models#check-your-deployment-type).
</Note>

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

<Steps>
  <Step>
    Log in to your [Qodo portal](https://app.qodo.ai/signin).
  </Step>

  <Step>
    From the left-hand navigation menu, select **Integrations**.
  </Step>

  <Step>
    Select the **SaaS** tab, locate the **GitLab** card, and click **Add installation** to launch the installation wizard.
  </Step>
</Steps>

## Install Qodo on GitLab Cloud

<Steps>
  <Step title="Before you begin">
    <Frame>
      <img src="https://mintcdn.com/qodo/lDsEo5S-rmYR1Zw1/images/code-review/gitlab/gl-step-1-before-you-begin.png?fit=max&auto=format&n=lDsEo5S-rmYR1Zw1&q=85&s=c51c7bf1190dd94a2f55010e5d71dd74" alt="GitLab wizard step 1 showing Before you begin screen with instruction to create a dedicated Qodo email address" width="1003" height="791" data-path="images/code-review/gitlab/gl-step-1-before-you-begin.png" />
    </Frame>

    <Steps>
      <Step>
        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.
      </Step>

      <Step>
        Click **Next**.
      </Step>
    </Steps>
  </Step>

  <Step title="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:

    <Steps>
      <Step title="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**.

        <Frame>
          <img src="https://mintcdn.com/qodo/lDsEo5S-rmYR1Zw1/images/code-review/gitlab/gl-step-2-invite-user.png?fit=max&auto=format&n=lDsEo5S-rmYR1Zw1&q=85&s=62f7b7fc334390b06a4e6d34fc829199" alt="GitLab wizard step 2 showing Invite members dialog with Qodo user email and Maintainer role highlighted" width="1002" height="793" data-path="images/code-review/gitlab/gl-step-2-invite-user.png" />
        </Frame>
      </Step>

      <Step title="Create the Qodo GitLab account">
        The invited user receives an email from GitLab. Accept the invitation and complete the account setup.

        <Note>The GitLab first name must be set as `Qodo`.</Note>

        <Frame>
          <img src="https://mintcdn.com/qodo/lDsEo5S-rmYR1Zw1/images/code-review/gitlab/gl-step-2-create-account.png?fit=max&auto=format&n=lDsEo5S-rmYR1Zw1&q=85&s=a1f3a77c7c3bcc36cf4a52691c5bc90a" alt="GitLab wizard step 2 showing Get started with GitLab signup form with First name set to Qodo highlighted" width="1000" height="793" data-path="images/code-review/gitlab/gl-step-2-create-account.png" />
        </Frame>
      </Step>

      <Step title="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.

        <Frame>
          <img src="https://mintcdn.com/qodo/lDsEo5S-rmYR1Zw1/images/code-review/gitlab/gl-step-2-add-avatar.png?fit=max&auto=format&n=lDsEo5S-rmYR1Zw1&q=85&s=715ff65e43baa46be50d78c121daa6ba" alt="GitLab wizard step 2 showing GitLab profile settings with Public avatar upload option" width="1006" height="794" data-path="images/code-review/gitlab/gl-step-2-add-avatar.png" />
        </Frame>
      </Step>
    </Steps>

    Back in the wizard, select the **Confirm GitLab Qodo account creation** checkbox, then click **Next**.
  </Step>

  <Step title="Install Qodo">
    <Steps>
      <Step>
        Enter your **GitLab Organization URL** (for example, `https://gitlab.com/yourgroup`) and click **Install Qodo**. You are redirected to GitLab to authorize access.

        <Frame>
          <img src="https://mintcdn.com/qodo/lDsEo5S-rmYR1Zw1/images/code-review/gitlab/gl-step-3-install-qodo.png?fit=max&auto=format&n=lDsEo5S-rmYR1Zw1&q=85&s=55957d1a805ef884926498d26cd3e912" alt="GitLab wizard step 3 showing Install Qodo screen with GitLab Organization URL field and maintainer requirement notes" width="1003" height="796" data-path="images/code-review/gitlab/gl-step-3-install-qodo.png" />
        </Frame>
      </Step>

      <Step>
        Review the requested permissions and click **Authorize Qodo-code-review**. You are redirected back to the wizard automatically.

        <Frame>
          <img src="https://mintcdn.com/qodo/lDsEo5S-rmYR1Zw1/images/code-review/gitlab/gl-step-3-authorize.png?fit=max&auto=format&n=lDsEo5S-rmYR1Zw1&q=85&s=aa4fac6f9b5c9b200d151ba1f909e2f5" alt="GitLab OAuth authorization dialog for Qodo-code-review requesting access to account on GitLab.com" width="762" height="422" data-path="images/code-review/gitlab/gl-step-3-authorize.png" />
        </Frame>
      </Step>
    </Steps>
  </Step>

  <Step title="Select repositories">
    <Steps>
      <Step>
        Select the repositories where you want to enable Qodo. Use the search bar to find specific repositories, or browse the group tree.

        <Frame>
          <img src="https://mintcdn.com/qodo/lDsEo5S-rmYR1Zw1/images/code-review/gitlab/gl-step-4-select-repositories.png?fit=max&auto=format&n=lDsEo5S-rmYR1Zw1&q=85&s=2af0f8d412b7b1eb9d0c1158fc80e0c7" alt="GitLab wizard step 4 showing Select repositories screen with group tree and checkboxes" width="1002" height="795" data-path="images/code-review/gitlab/gl-step-4-select-repositories.png" />
        </Frame>
      </Step>

      <Step>
        Click **Setup** to continue.
      </Step>
    </Steps>
  </Step>

  <Step title="Check connection">
    <Frame>
      <img src="https://mintcdn.com/qodo/lDsEo5S-rmYR1Zw1/images/code-review/gitlab/gl-step-5-check-connection.png?fit=max&auto=format&n=lDsEo5S-rmYR1Zw1&q=85&s=07ecceb4d80d237cbc9c2a44a70e6bbd" alt="GitLab wizard step 5 showing Check connection with GitLab installation is successful confirmation" width="1002" height="794" data-path="images/code-review/gitlab/gl-step-5-check-connection.png" />
    </Frame>

    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.
  </Step>

  <Step title="Installation complete">
    <Frame>
      <img src="https://mintcdn.com/qodo/lDsEo5S-rmYR1Zw1/images/code-review/gitlab/gl-step-6-installation-complete.png?fit=max&auto=format&n=lDsEo5S-rmYR1Zw1&q=85&s=e7288bd59bc91d0d7841ccb94cb83aa2" alt="GitLab wizard step 6 showing Installation complete with connected repository count and enabled capabilities" width="1004" height="792" data-path="images/code-review/gitlab/gl-step-6-installation-complete.png" />
    </Frame>

    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**.
  </Step>
</Steps>

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

<Steps>
  <Step>
    Open a new merge request in one of the connected repositories and confirm Qodo is triggered automatically.
  </Step>

  <Step>
    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.
  </Step>
</Steps>

## Next steps

* [Repositories page](/administration/repositories): Enable or disable Qodo on individual repositories within your current scope.
* [Using Qodo in PRs](/code-review/use-qodo-in-prs): Get the most out of Qodo.
* [Migration guide](/install-and-configure/install/gitlab/migration): Migrate an existing Qodo installation.
