> ## 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 - Single-tenant and Enterprise Server

> Single-tenant and GitHub Enterprise Server install guide for Qodo automated code review.

<Note>
  * This guide applies to the following deployment combinations, all of which use the same installation wizard:
    * Qodo single-tenant with GitHub Cloud
    * Qodo single-tenant with GitHub Enterprise Server
    * Qodo multi-tenant with GitHub Enterprise 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).
</Note>

This guide walks you through installing Qodo on GitHub using the built-in wizard. Assuming your Qodo environment is already set up, the process takes about 5 minutes.

## Prerequisites

Before you begin, ensure you have:

* Access to your Qodo portal.
* Sufficient permissions to create GitHub applications.

## Access the GitHub integration

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

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

  <Step>
    Locate the relevant card and click **Add installation** to launch the setup wizard:

    * If you are using **GitHub Cloud**, select the **SaaS** tab and locate the **GitHub** card.
    * If you are using **GitHub Enterprise Server**, select the **Self-Hosted** tab and locate the **GitHub Enterprise** card.
  </Step>
</Steps>

## Install Qodo using the wizard

The wizard guides you through six steps:

{/*
```mermaid
flowchart LR
  A("1.<br/>Organization<br/>details") --> B("2.<br/>Review<br/>manifest") --> C("3.<br/>Install<br/>guide") --> D("4.<br/>Check<br/>connection") --> E("5.<br/>Recommended<br/>display") --> F("6.<br/>Enable<br/>Qodo")
```
*/}

<Steps>
  <Step title="Enter organization details">
    Enter your GitHub organization homepage URL and click **Next**. If you are using GitHub Enterprise Server, enter your server's homepage URL (for example, `https://github.mycompany.com`).

    <Frame>
      <img src="https://mintcdn.com/qodo/8f9QSVoLIbSaCs56/images/code-review/github-wizard-org-details.png?fit=max&auto=format&n=8f9QSVoLIbSaCs56&q=85&s=3e0ff16f8f7edeacbe3d2ec6ae5fbc22" alt="GitHub integration wizard step showing organization homepage URL field" width="975" height="744" data-path="images/code-review/github-wizard-org-details.png" />
    </Frame>
  </Step>

  <Step title="Review the manifest">
    <Steps>
      <Step>
        Review the **Manifest**, which defines the configurations and permissions Qodo requires. If you have questions about permissions or need adjustments, contact your **Qodo Account Manager** before proceeding.
      </Step>

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

  <Step title="Install the GitHub App">
    Review the **Installation guide** for the steps you will configure in GitHub, then click **Install GitHub App**. You are redirected to GitHub.

    **In GitHub**

    <Steps>
      <Step>
        Enter a name for the GitHub App (for example, your organization name + Qodo).
      </Step>

      <Step>
        Click **Create GitHub App for \[your organization name]**.
      </Step>

      <Step>
        Select the GitHub user account to authorize the app. If the displayed account is correct, click **Continue**; otherwise sign in with a different account.
      </Step>

      <Step>
        Select which repositories Qodo can access: **All repositories** (recommended) or **Selected repositories only**. Repository-level settings can later be managed from the Qodo portal.

        <Frame>
          <img src="https://mintcdn.com/qodo/8f9QSVoLIbSaCs56/images/code-review/github-app-install-permissions.png?fit=max&auto=format&n=8f9QSVoLIbSaCs56&q=85&s=953a83b097ad8086d5a5762adc6b74e3" alt="GitHub App installation page showing repository access permission options" width="1024" height="1317" data-path="images/code-review/github-app-install-permissions.png" />
        </Frame>
      </Step>

      <Step>
        Click **Install**. You are redirected back to the Qodo portal.
      </Step>
    </Steps>
  </Step>

  <Step title="Check the connection">
    <Steps>
      <Step>
        Check for a *"GitHub installation successful"* message.
      </Step>

      <Step>
        Click **Next**. If unsuccessful, click **Test Connection** to retry. If it fails again, contact your **Qodo Account Manager**.
      </Step>
    </Steps>
  </Step>

  <Step title="Configure recommended display">
    To ensure Qodo appears consistently in pull requests:

    <Steps>
      <Step>
        Click **Download logo** to download the official Qodo logo.
      </Step>

      <Step>
        Click **Upload logo to the display information settings on GitHub** to open the GitHub App settings page.
      </Step>

      <Step>
        Upload the Qodo logo as the app logo and click **Save**. You are redirected back to the Qodo portal wizard.
      </Step>

      <Step>
        Click **Next**.

        <Frame>
          <img src="https://mintcdn.com/qodo/8f9QSVoLIbSaCs56/images/code-review/github-wizard-display-step.png?fit=max&auto=format&n=8f9QSVoLIbSaCs56&q=85&s=faaecd164b699d4e6a278ace0cf8b291" alt="GitHub integration wizard display configuration step with logo upload option" width="979" height="735" data-path="images/code-review/github-wizard-display-step.png" />
        </Frame>
      </Step>
    </Steps>
  </Step>

  <Step title="Enable Qodo">
    * Click **Finish Installation**.

    <Frame>
      <img src="https://mintcdn.com/qodo/8f9QSVoLIbSaCs56/images/code-review/github-wizard-finish-installation.png?fit=max&auto=format&n=8f9QSVoLIbSaCs56&q=85&s=57f88b7b9722bca0ce67cf363d372b69" alt="GitHub integration wizard final step with Finish Installation button" width="997" height="733" data-path="images/code-review/github-wizard-finish-installation.png" />
    </Frame>

    You are redirected to the **Integrations** page, where the GitHub card shows your connected organizations.

    <img src="https://mintcdn.com/qodo/8f9QSVoLIbSaCs56/images/code-review/github-integration-card-orgs.png?fit=max&auto=format&n=8f9QSVoLIbSaCs56&q=85&s=803e82380c353cc6048690479238eb63" alt="GitHub integration card in Qodo portal showing number of connected organizations" style={{width: '200px'}} width="250" height="151" data-path="images/code-review/github-integration-card-orgs.png" />
  </Step>
</Steps>

Qodo is now active on the selected repositories.

## Verify the installation

<Steps>
  <Step>
    Open a new pull request in the configured repositories and confirm that 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.

## Next steps

* [Using Qodo in PRs](/code-review/use-qodo-in-prs): Get the most out of Qodo.
* [Repositories page](/administration/repositories): Manage which repositories Qodo is active on.