> ## 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 wizard in one of the following ways:

    <Steps>
      <Step title="From the Integrations page">
        Navigate to **Integrations**, select the **SaaS** tab, and click **Add installation** on the **GitHub** card.
      </Step>

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

## 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.