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

# Bitbucket Data Center

> This guide explains how to connect Qodo Context Engine to Bitbucket Data Center.

## Prerequisites

1. Bitbucket Data Center instance (Customer). **Must be version 8.X.X (does not work on 9.X.X)**.

* **App uploading is enabled:** Go to settings, then select **Manage apps.** Make sure **Upload app** link is visible.

To enable app installation in the bitbucket.properties file, set the property: `upm.plugin.upload.enabled=true`.

## 1. App installation

<Steps>
  <Step title="Download the Qodo app file">
    Please contact Qodo Support for the file.
  </Step>

  <Step title="Install the Qodo App">
    Go to settings, then select **Manage apps**. Click the **Upload app** link and select the **Select jar file** option. Select the Qodo app file you downloaded previously.
  </Step>

  <Step title="Define Access token">
    1. Login to Bitbucket as system administrator.

    2. Click your profile picture, then select **Manage account**. Select **http access token**, then select **add token**.

    3. Give the token a meaningful name.

    4. Under **Project permissions**, select the **Project write** permissions.

    5. Under **Repository permissions**, select the **Repository write (inherited)** permissions.

    6. Copy the token and save it for later.
  </Step>

  <Step title="Check out your Qodo app">
    Your Qodo app is ready. You can see it at the Administration section.

    Each Qodo tool has a configuration tab in the app. Use the connection section to define the URL of your Qodo tool. Use the **Repositories** section to select the repositories integrated into Qodo Context Engine.
  </Step>
</Steps>

## 2. Send relevant information to Qodo

After the setup, share the following credentials with the Qodo team:

```bash theme={null}
[bitbucket_data_center] # or Bitbucket Cloud

base_url = "https://your-bbdc-instance.com" # url of your bbdc instance

webhook_secret = "mysecret" # the secret you wrote in the Qodo BBDC app for the tool. Currently Company Codebase does not support any webhooks, so this setting is optional

bearer_token = "BBDC-mytoken" # the token you created in the BBDC instance for Qodo
```

## 3. (Optional) Set a custom certificate bundle

If your self-hosted Git server uses a custom CA SSL certificate, share your ca-certificate.pem file with the Qodo team.