> ## 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 Bitbucket Cloud (on-premises)

> Install and configure the Bitbucket Cloud integration for Qodo on-premises deployments.

This guide helps you install and configure Qodo on-premises with your Bitbucket Cloud workspace.

Assuming your Qodo environment is already set up, configuring Bitbucket typically takes about 10 minutes.

Once complete, Qodo processes pull requests and delivers actionable output such as code reviews and insights, directly in your pull requests.

## Prerequisites

Before you begin, ensure you have:

* **A Qodo on-premises deployment.** You will receive your Qodo on-premises URL from your Qodo Account Manager. It typically looks like: `qodo-merge.yourcompanyname.qodo.ai`
* **System administrator access to your Bitbucket workspace.**

## Installation

<Steps>
  <Step>
    Navigate to **Settings** (cog wheel) → **Workspace settings**.

    <Frame>
      <img src="https://mintcdn.com/qodo/0-xdxIQcOR89aG3r/images/qodo-documentation/code-review/image-20.png?fit=max&auto=format&n=0-xdxIQcOR89aG3r&q=85&s=09636ab7d8010b5db463ad97f390f9ce" alt="Bitbucket workspace settings navigation" width="567" height="453" data-path="images/qodo-documentation/code-review/image-20.png" />
    </Frame>
  </Step>

  <Step>
    On the left-hand side menu, navigate to **Installed apps**.

    <Frame>
      <img src="https://mintcdn.com/qodo/0-xdxIQcOR89aG3r/images/qodo-documentation/code-review/image-21.png?fit=max&auto=format&n=0-xdxIQcOR89aG3r&q=85&s=6e63f5b5ae4f796fa71493ebd255a2b2" alt="Bitbucket workspace installed apps menu" width="595" height="686" data-path="images/qodo-documentation/code-review/image-21.png" />
    </Frame>
  </Step>

  <Step>
    Enable **Development mode** to allow app installation, then click **Install app from URL**.

    <Frame>
      <img src="https://mintcdn.com/qodo/0-xdxIQcOR89aG3r/images/qodo-documentation/code-review/image-22.png?fit=max&auto=format&n=0-xdxIQcOR89aG3r&q=85&s=ae53dba18d73adc88fc08012e2dd17d5" alt="Bitbucket Manage apps page with Development mode enabled and Install app from URL button" width="891" height="430" data-path="images/qodo-documentation/code-review/image-22.png" />
    </Frame>
  </Step>

  <Step>
    Enter your Qodo on-premises URL and click **Install**.

    <Frame>
      <img src="https://mintcdn.com/qodo/0-xdxIQcOR89aG3r/images/qodo-documentation/code-review/image-23.png?fit=max&auto=format&n=0-xdxIQcOR89aG3r&q=85&s=b773441218fe9583e81064c117ad93f2" alt="Bitbucket Install app from URL dialog with Qodo URL entered" width="987" height="507" data-path="images/qodo-documentation/code-review/image-23.png" />
    </Frame>
  </Step>

  <Step>
    In the popup displayed, click **Grant access** to the app.

    <Frame>
      <img src="https://mintcdn.com/qodo/0-xdxIQcOR89aG3r/images/qodo-documentation/code-review/image-24.png?fit=max&auto=format&n=0-xdxIQcOR89aG3r&q=85&s=2bb2be9b3544a8abc45bfb8dcd494bbf" alt="Bitbucket Grant access popup for Qodo app" width="720" height="472" data-path="images/qodo-documentation/code-review/image-24.png" />
    </Frame>
  </Step>

  <Step>
    Add your Bitbucket workspace ID to your Qodo on-premises configuration to complete the setup.
  </Step>
</Steps>

Qodo is now enabled for all repositories within your Bitbucket workspace.

## Verify the installation

### Run a test pull request

<Steps>
  <Step>
    Open a new pull request in one of the integrated 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>

## Next steps

[Using Qodo in PRs](/code-review/get-started/use-qodo-in-prs): Get the most out of Qodo.