> ## 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 GitHub Cloud - Multi-tenant

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

<Note>
  Using GitHub Enterprise Server? The installation flow is the same as Qodo single-tenant. See [Qodo single-tenant](/install-qodo/github/qodo-single-tenant).
</Note>

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

Install Qodo on GitHub Cloud using the built-in wizard. Installing from the Qodo portal rather than GitHub Marketplace ensures every feature is enabled and correctly configured. Assuming your environment is already set up, the process takes about 5 minutes.

## Prerequisites

Before you begin, ensure you have:

* Access to your Qodo multi-tenant portal.
* GitHub organization admin access.

## Access the GitHub integration

<Warning>
  Install using the GitHub account and Qodo workspace you intend to use for your organization going forward. A GitHub organization stays bound to whichever Qodo workspace installs it first, and reassigning it to a different workspace later requires contacting Qodo support. See [Troubleshooting](#troubleshooting).
</Warning>

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

  <Step>
    Start the installation wizard in one of the following ways:

    * **From the onboarding wizard**: If you're an organization admin signing in for the first time, the onboarding wizard opens automatically. In the Connect Git step, select **GitHub**. See [Set up Qodo with the onboarding wizard](/onboarding-wizard).
    * **From the homepage**: On the homepage, in the top right-hand side, click the **+** button next to Git providers. On the selection page, choose **GitHub**.
  </Step>
</Steps>

## Install Qodo using the wizard

The wizard guides you through two steps:

<Steps>
  <Step title="Review the install guide">
    The wizard shows the install guide, a preview of the repository access configuration you will complete on GitHub.

    <Frame>
      <img src="https://mintcdn.com/qodo/DqMegLtJq4I1K-zc/images/code-review/github-mt-wizard-install-guide.png?fit=max&auto=format&n=DqMegLtJq4I1K-zc&q=85&s=970dceaf0bea848931e59829b5cd3f0c" alt="GitHub MT wizard install guide step showing repository scope options" style={{width: '100%'}} width="1983" height="1475" data-path="images/code-review/github-mt-wizard-install-guide.png" />
    </Frame>

    <Steps>
      <Step>
        Click **Connect your organization**. You are redirected to GitHub.
      </Step>

      <Step>
        Authorize the installation and confirm repository access, then click **Install**. You are redirected back to the Qodo wizard.
      </Step>
    </Steps>
  </Step>

  <Step title="Complete the installation">
    The wizard confirms that Qodo has been successfully installed on your GitHub organization and that AI code review, auto rule generation, and codebase context are enabled.

    <Frame>
      <img src="https://mintcdn.com/qodo/DqMegLtJq4I1K-zc/images/code-review/github-mt-wizard-install-complete.png?fit=max&auto=format&n=DqMegLtJq4I1K-zc&q=85&s=10ab98d6a6395197c9155153f4e5a774" alt="GitHub MT wizard installation complete screen" width="1969" height="1496" data-path="images/code-review/github-mt-wizard-install-complete.png" />
    </Frame>

    Click **Finish installation**. You are redirected to the **Integrations** page.
  </Step>
</Steps>

Qodo is now active on the selected repositories.

<Note>
  If you're connecting your Git provider as part of the onboarding wizard, the wizard continues to the next onboarding step once the connection completes. See [Set up Qodo with the onboarding wizard](/onboarding-wizard).
</Note>

## What happens after you connect

Qodo starts building context for your code reviews, and the following processes run automatically in the background:

* [Repository sync](/governance/repositories/installations): Syncs each connected repository with Qodo.
* [Pull request indexing](/governance/repositories/manage-repositories#check-repository-pr-history-indexing-status): Indexes each repository's pull request history.
* [Cross-repo discovery](/governance/repositories/relationships): Finds relationships between your repositories.

Track their progress from **Background activity** in the top-right corner of the portal. If a process needs attention, see [Troubleshoot background processes](/governance/troubleshoot-background-processes).

<Tip>
  It's recommended to import your team's existing rules and skills, which lets Qodo enforce your coding standards in its reviews. See [Importing rules and skills](/governance/rule-enforcement/building-review-standards#importing-rules-and-skills).
</Tip>

## Verify the installation

<Steps>
  <Step>
    Open a new pull request in one of the configured 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 PR summary directly on the pull request.
  </Step>
</Steps>

## Manage repositories after installation

* To add or remove repositories, go to your GitHub App settings and update which repositories the app can access.
* To enable or disable Qodo on individual repositories within your current scope, use the [Repositories page](/administration/repositories) in the Qodo portal.

## Troubleshooting

### GitHub organization already connected to another workspace

If you see this message:

```
This GitHub organization is already connected to another Qodo workspace.
```

Error code: `GITHUB_ID_ALREADY_CLAIMED`

Common causes:

* A personal account installed Qodo before a company account did.
* The account that originally installed Qodo was deleted.
* A different company account installed Qodo on the same organization.

This can also happen silently: clicking **Add installation** on the Integrations page redirects to a GitHub page for managing an app that's already installed, instead of the Qodo setup wizard. Back in the Qodo portal, the organization still shows as not connected, with no error shown.

Contact [Qodo support](mailto:support@qodo.ai) with the GitHub organization name to identify and resolve the existing installation.

## Next steps

* [Trigger a code review](/code-review/use-qodo-in-prs): Run a review automatically or on demand.
* [Repositories page](/administration/repositories): Manage which repositories Qodo is active on.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.