> ## 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 v1.x on Bitbucket Data Center

> Qodo v1.x installation guide for Bitbucket Data Center.

<Warning>
  **Git Integration (formerly Qodo Merge)** – AI code review agents for pull requests. This documentation describes the Qodo v1 experience. For the Qodo v2 documentation, click [here.](/code-review)
</Warning>

This guide will help you install and configure Qodo with your Bitbucket Data Center (BBDC) instance.

You can install it for a single repository or expand it across multiple projects as needed.

Assuming your Qodo environment is setup, expect configuring BBDC to take about 20 minutes, including creating tokens, configuring the service, and setting up webhooks.

Once complete, Qodo will process pull requests and deliver actionable output, such as code reviews and insights, directly to your PRs. Setting up Qodo for BBDC brings automated PR intelligence to your self-hosted environment.

<Note>
  **This connection method is available only to Enterprise customers.** [**Contact Qodo**](https://www.qodo.ai/contact/#pricing) **to use Qodo Git interface on your private Bitbucket server.**
</Note>

## Prerequisites

Before you begin, ensure you have:

1. A Qodo single-tenant deployment (for Code Review)
2. Receive your Qodo single-tenant URL from your Qodo Account Manager
3. A Bitbucket Data Center instance (version 8.x or 9.x)
4. System administrator access to your BBDC instance
5. App upload capability enabled in BBDC

<Note>
  If you require version 10.x of Bitbucket Data Center contact your Qodo Account Manager.
</Note>

### Verify app upload is enabled

<Steps>
  <Step>
    Navigate to **Settings → Manage Apps**
  </Step>

  <Step>
    Confirm the "Upload app" link is visible
  </Step>

  <Step>
    If not visible, ask your Bitbucket admin to add `upm.plugin.upload.enabled=true` to your `bitbucket.properties` file

    <Frame>
      <img src="https://mintcdn.com/qodo/uIkZ6kAWHm6WXqrW/images/v1/image-116.jpeg?fit=max&auto=format&n=uIkZ6kAWHm6WXqrW&q=85&s=52f681ce616d19a19dbbcee9c79eba17" alt="" width="2304" height="840" data-path="images/v1/image-116.jpeg" />
    </Frame>
  </Step>
</Steps>

## Installation steps

### Step 1: Install the Qodo App

<Steps>
  <Step>
    Go to **Settings → Manage Apps → Upload App**
  </Step>

  <Step>
    Download the appropriate version ([download JAR file](https://github.com/qodo-ai/BBDC-App-Releases?tab=readme-ov-file#installation)):

    * **BBDC 8.x**: Use `qodo-app-bbdc-2.x.x.jar`
    * **BBDC 9.x**: Use `qodo-app-bbdc-3.x.x.jar`
  </Step>

  <Step>
    Upload the JAR file to your BBDC instance
  </Step>

  <Step>
    Verify the app is enabled after installation (check "Manage Apps" if needed)
  </Step>
</Steps>

<Note>
  **Note:**

  Contact your Qodo representative for the latest app version if compatible with your BBDC instance is not available.
</Note>

<Frame>
  <img src="https://mintcdn.com/qodo/uIkZ6kAWHm6WXqrW/images/v1/image-117.png?fit=max&auto=format&n=uIkZ6kAWHm6WXqrW&q=85&s=36fb089536ac8252db28b5235d70ea98" alt="" width="2130" height="1196" data-path="images/v1/image-117.png" />
</Frame>

### Step 2: Create access token

You'll need to create an HTTP access token for Qodo to communicate with BBDC.

**Optional: Create a Dedicated Service Account**

For better visibility, create a dedicated system administrator user (e.g., "Qodo") before generating the token. All PR comments will appear under this user's name.

**Generate the Token**

<Steps>
  <Step>
    Log in to BBDC as a system administrator
  </Step>

  <Step>
    Click **Profile Picture → Manage Account → HTTP Access Tokens**
  </Step>

  <Step>
    Click **Create Token**
  </Step>

  <Step>
    Configure the token:

    * **Name**: Qodo Integration
    * **Permissions**: Repository Write access (minimum required)
  </Step>

  <Step>
    Click **Create**
  </Step>

  <Step>
    **Important**: Copy and save the bearer token immediately. You won't be able to see it again
  </Step>
</Steps>

<Frame caption="Qodo app enabled in Manage Apps">
  <img src="https://mintcdn.com/qodo/uIkZ6kAWHm6WXqrW/images/v1/image-118.png?fit=max&auto=format&n=uIkZ6kAWHm6WXqrW&q=85&s=6408103e44a9a7c05d9d6f40eb47d4aa" alt="" width="872" height="652" data-path="images/v1/image-118.png" />
</Frame>

### Step 3: Create a shared webhook secret

Choose a strong secret (it can be anything). You can use any secret generation tool you prefer.

### Step 4: Configure the Qodo App in BBDC

<Steps>
  <Step>
    Navigate to **Administration → Add-ons → Qodo**
  </Step>

  <Step>
    Select the **Qodo Merge** tab
  </Step>

  <Step>
    In the **Connection** section, enter:

    * **Single-tenant Qodo Merge URL**: Your Qodo Merge instance URL (ask your Qodo Account manager)
    * **Shared Webhook Secret**: The same webhook secret you create in step 3

    <Frame>
      <img src="https://mintcdn.com/qodo/uIkZ6kAWHm6WXqrW/images/v1/image-119.png?fit=max&auto=format&n=uIkZ6kAWHm6WXqrW&q=85&s=354d448a6e5f02028359d4271adb23ec" alt="" width="990" height="988" data-path="images/v1/image-119.png" />
    </Frame>
  </Step>
</Steps>

### Step 5: Configure repository integration

Choose how Qodo Merge will integrate with your repositories:

**Integration Modes:**

* **All repositories** (default): Qodo Merge will be active on all repositories
* **Selected repositories only**: Choose specific repositories to integrate
* **All repositories except**: Exclude specific repositories from integration

<Steps>
  <Step>
    In the Qodo App configuration, navigate to the **Repositories** section
  </Step>

  <Step>
    Select your preferred integration mode
  </Step>

  <Step>
    If using selective modes, specify the repositories
  </Step>

  <Step>
    Make sure your changes are saved

    <Frame>
      <img src="https://mintcdn.com/qodo/uIkZ6kAWHm6WXqrW/images/v1/image-120.png?fit=max&auto=format&n=uIkZ6kAWHm6WXqrW&q=85&s=94becaaa513c48e86581f6703a8b5e6b" alt="" width="2304" height="821" data-path="images/v1/image-120.png" />
    </Frame>
  </Step>
</Steps>

### Step 6: Send Bitbucket app details to Qodo

Provide Qodo account contact the following details to configure your Qodo instance with the following settings:

```bash theme={null}
# URL to your BitBucket Data Center instance
url = "https://your-bbdc-instance.com"

# Bearer token from Step 2
bearer_token = "your-bearer-token-here"

# Shared secret for webhook verification 
webhook_secret = "your-webhook-secret-here"
```

<Note>
  **Production Note:**

  For production environments, follow your organization's secret management procedures to securely store these credentials.
</Note>

<Note>
  Well Done. Now wait for the Qodo Team to confirm installation was successful.
</Note>

## Verification

After confirmation, you can test the installation.

### Test connection

* Navigate to **Administration → Add-ons → Qodo**
* Select the **Qodo Merge** tab
* In the **Connection** section, click **"Test Connection"**

<Frame>
  <img src="https://mintcdn.com/qodo/uIkZ6kAWHm6WXqrW/images/v1/image-121.png?fit=max&auto=format&n=uIkZ6kAWHm6WXqrW&q=85&s=78f6df01e2aca80d84b327e28c448b67" alt="" width="1856" height="1158" data-path="images/v1/image-121.png" />
</Frame>

### Run a test PR

<Steps>
  <Step>
    **Open a new pull request** in one of your integrated repositories
  </Step>

  <Step>
    Qodo Merge should automatically post a review comment
  </Step>

  <Step>
    Alternatively, add a comment with `/improve` to an existing PR
  </Step>

  <Step>
    Verify that Qodo Merge responds with code suggestions
  </Step>
</Steps>

### Troubleshooting

If Qodo Merge isn't responding:

* Verify the app is enabled in **Settings → Manage Apps**
* Check that your repository matches your integration mode settings
* Confirm the bearer token has appropriate permissions
* Verify the webhook secret matches in both BBDC and Qodo Merge configurations
* Check the Qodo Merge logs for connection errors

## Available commands

Once installed, you can use Qodo Merge commands in PR comments:

* `/review` - Perform a code review
* `/improve` - Suggest code improvements
* `/describe` - Generate a PR description
* `/ask` - Ask questions about the code changes