> ## 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 Data Center (on-premises)

> Install guide for Qodo automated code review on Bitbucket Data Center, using the guided installation wizard.

Qodo works directly with Bitbucket Data Center, using a dedicated Bitbucket user (`qodo-bot`) to post code review comments on pull requests. Qodo creates this account automatically using administrator credentials you provide during setup, then discards them. It relies on project-level webhooks to deliver automated insights.

You can configure Qodo for selected projects or across your entire Bitbucket Data Center server. Configuration typically takes around 5 minutes.

Once installed, Qodo automatically processes pull requests and delivers actionable insights, such as code reviews, descriptions, and improvement suggestions, directly within your Bitbucket workflow.

## Prerequisites

Before you begin, ensure you have:

* Access to your Qodo portal.
* A Qodo environment configured for Bitbucket Data Center.
* Bitbucket System Administrator access, to sign in and complete setup.

## Access the Bitbucket Data Center integration

<Steps>
  <Step>
    Log in to your Qodo portal.
  </Step>

  <Step>
    Navigate to **Integrations**.
  </Step>

  <Step>
    Select the **Self hosted** tab, locate the **Bitbucket Data Center** card, and click **Add installation** to launch the installation wizard.
  </Step>
</Steps>

## Install Qodo on Bitbucket Data Center

<Steps>
  <Step title="Before you begin">
    <Frame>
      <img src="https://mintcdn.com/qodo/ihsSIlMbbHbF_3In/images/code-review/bitbucket/bbdc-step-1-before-you-begin.png?fit=max&auto=format&n=ihsSIlMbbHbF_3In&q=85&s=8e0e8dec4de9d45b98f1d04a949e9bf9" alt="Bitbucket Data Center installation wizard showing the Before you begin step, with the administrator sign-in requirement, what Qodo uses it for, the qodo-bot permissions, and a note that credentials are never stored" width="1533" height="1026" data-path="images/code-review/bitbucket/bbdc-step-1-before-you-begin.png" />
    </Frame>

    A Bitbucket administrator username and password are required to complete this setup.

    Qodo uses this sign-in once to:

    * Create a dedicated Qodo user (`qodo-bot`)
    * Register the required webhooks

    `qodo-bot` receives a Licensed User role and write access (`PROJECT_WRITE` or `REPO_WRITE`), limited to the projects and repositories you select. Write access lets it post pull request descriptions; it doesn't grant repository or project administrator permissions.

    <Note>
      Your credentials are never stored. You can change the administrator password immediately after setup completes; reviews continue running on the `qodo-bot` account. An administrator sign-in is required again only if you delete the installation, to remove the webhooks `qodo-bot` created.
    </Note>

    Click **Continue**.
  </Step>

  <Step title="Connect your server">
    <Frame>
      <img src="https://mintcdn.com/qodo/ihsSIlMbbHbF_3In/images/code-review/bitbucket/bbdc-step-2-connect-your-server.png?fit=max&auto=format&n=ihsSIlMbbHbF_3In&q=85&s=3b8003da98937bc40af6689e600b01ce" alt="Bitbucket Data Center installation wizard showing the Connect your server step, with the server URL, administrator username and password fields filled in, and the three passed Test connection checks" width="1450" height="1085" data-path="images/code-review/bitbucket/bbdc-step-2-connect-your-server.png" />
    </Frame>

    Enter your Bitbucket Data Center server URL and administrator credentials.

    <Steps>
      <Step>
        Enter your **server URL**, for example `https://bitbucket.example.com`.
      </Step>

      <Step>
        Enter your **administrator username** and **administrator password**.

        <Note>
          Your password is never stored, and is discarded as soon as setup finishes. Bitbucket requires a password rather than a token to create a user.
        </Note>
      </Step>

      <Step>
        Optionally, click **Test connection** to verify the server and sign-in without creating the Qodo account or webhooks. On success, Qodo confirms the server is reachable, the sign-in is accepted, and the account has administrator permissions.
      </Step>

      <Step>
        Click **Connect to Bitbucket**.
      </Step>
    </Steps>
  </Step>

  <Step title="Select repositories">
    <Frame>
      <img src="https://mintcdn.com/qodo/ihsSIlMbbHbF_3In/images/code-review/bitbucket/bbdc-step-3-select-repositories.png?fit=max&auto=format&n=ihsSIlMbbHbF_3In&q=85&s=63d4d033e3092dcddc6a175342074a33" alt="Bitbucket Data Center installation wizard showing the Select repositories step, with the search bar and a list of projects to choose from" width="1448" height="1086" data-path="images/code-review/bitbucket/bbdc-step-3-select-repositories.png" />
    </Frame>

    <Steps>
      <Step>
        Select which projects or repositories Qodo should review.

        * Use the search bar to find a specific project or repository, or browse the list of projects on your server.
        * Selecting a project includes every repository in it, including ones created later.
        * Selecting an individual repository includes only that repository.
      </Step>

      <Step>
        Click **Connect repositories**.
      </Step>
    </Steps>
  </Step>

  <Step title="Install Qodo">
    <Frame>
      <img src="https://mintcdn.com/qodo/ihsSIlMbbHbF_3In/images/code-review/bitbucket/bbdc-step-4-setup-complete.png?fit=max&auto=format&n=ihsSIlMbbHbF_3In&q=85&s=d10c197a12c14c1d48c7e362a6cf4a62" alt="Bitbucket Data Center installation wizard showing the Setup complete step, confirming the number of repositories connected" width="1536" height="1024" data-path="images/code-review/bitbucket/bbdc-step-4-setup-complete.png" />
    </Frame>

    Qodo creates the `qodo-bot` account and registers the required webhooks in Bitbucket.

    Once setup completes, Qodo confirms the number of repositories connected. Reviews are posted by the `qodo-bot` account; Qodo warns you before its token expires.

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

Qodo is now active on the repositories in the projects you selected. To add more projects, return to this wizard at any time and run a new installation with the updated scope. Projects that already have Qodo installed are not available for selection. To reduce scope, remove the installation and create a new one.

## Verify the installation

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

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