> ## 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 - Single-tenant and GitLab Server
> Single-tenant and GitLab Server install guide for Qodo automated code review.
* This guide applies to the following deployment combinations, all of which use the same installation wizard:
* Qodo single-tenant with GitLab Cloud
* Qodo single-tenant with GitLab Server
* Qodo multi-tenant with GitLab Server
* 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).
Qodo works directly with GitLab, 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–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.
* A Qodo environment configured for GitLab.
* GitLab group administrator access.
* 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
Log in to your Qodo portal. For single-tenant accounts, your portal URL follows the pattern `app.yourcompany.st.qodo.ai` and is provided by your Qodo Account Manager.
From the left-hand navigation menu, select **Integrations**.
Locate the relevant card and click **Add installation** to launch the installation wizard:
* If you are using **GitLab Cloud**, select the **SaaS** tab and locate the **GitLab** card.
* If you are using **GitLab Server**, select the **Self-Hosted** tab and locate the **GitLab** card.
## Install Qodo on GitLab
Under connection method, select **Sign in with OAuth**. The **Access token** option is coming soon.
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.
Click **Next**.
In this step you create a GitLab OAuth application so Qodo can connect to your GitLab group.
* Click **Copy URL to paste in GitLab** and keep it ready for sub-step 1.
Complete the following steps in GitLab:
In GitLab, go to your group **Settings → Applications → Add new application**. Configure the application with the following settings:
* **Name:** Qodo
* **Redirect URI:** Paste the URL copied from the wizard
* **Confidential:** Ensure the **Confidential** checkbox is selected
* **Scopes:** Ensure the **api** checkbox is selected
Click **Save application**.
After saving, GitLab displays the application credentials. Copy both the **Application ID** and the **Secret** and store them safely.
This is the only time the secret is accessible. Copy it before leaving this page.
Back in the wizard, click **Next**.
Enter the following details from the previous step:
* **GitLab group URL(s):** Paste one group URL per line to connect several groups at once, for example `https://gitlab.com/yourgroup`. Each URL becomes its own installation.
* **Application ID:** The Application ID copied in step 2
* **Application Secret:** The Secret copied in step 2
A single OAuth application authorizes all the groups you list, so you only need the one Application ID and Secret from step 2. Each group becomes a separate installation, listed individually on the [Repositories page](/governance/repositories).
Click **Next**.
Using the email you created in step 1, 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:
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**.
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`.
In the Qodo account's GitLab profile settings, go to **Edit Profile** and upload the Qodo logo as the public avatar.
Back in the wizard, select the **Confirm GitLab Qodo account creation** checkbox and click **Install Qodo**. You are redirected to GitLab to authorize access.
Review the requested permissions and click **Authorize**. You are redirected back to the wizard automatically.
Select the repositories where you want to enable Qodo. Use the search bar to find specific repositories, or browse the group tree.
Click **Setup** to continue.
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.
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
Open a new merge request in one of the connected repositories and confirm Qodo is triggered automatically.
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
* [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.