Bitbucket Data Center

Learn more about setting up Qodo on Bitbucket Data Center

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

You can install Qodo on a single repository to start small or expand it across multiple projects as needed.

Assuming your Qodo environment is already set up, configuring BBDC typically takes about 20 minutes. This includes creating access tokens, configuring the service, and setting up webhooks.

Once complete, Qodo processes pull requests and delivers actionable output—such as code reviews and insights—directly in your pull requests. Setting up Qodo for BBDC brings automated pull request intelligence to your self-hosted environment.

This connection method is available only to Enterprise customers. Contact the Qodo team to enable the Git integration for your private Bitbucket Data Center instance.

Prerequisites

Before you begin, ensure you have:

• A Qodo single-tenant deployment (for code review) You will receive your Qodo single-tenant URL from your Qodo Account Manager.

• A Bitbucket Data Center instance Version 8.x or 9.x

• System administrator access to your Bitbucket Data Center instance.

• App upload capability enabled in Bitbucket Data Center.

If you require Bitbucket Data Center version 10.x, contact your Qodo Account Manager.

Verify App Upload is Enabled

1. Navigate to Settings → Manage Apps.

2. Confirm the Upload app link is visible.

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

Installation

Step 1: Install the Qodo App

1. Go to Settings → Manage Apps → Upload App

2. Download the appropriate version (download JAR file):

   • BBDC 8.x: Use qodo-app-bbdc-2.x.x.jar

   • BBDC 9.x: Use qodo-app-bbdc-3.x.x.jar

3. Upload the JAR file to your BBDC instance

4. Verify the app is enabled after installation (check "Manage Apps" if needed)

Contact your Qodo representative for the latest app version compatible with your BBDC instance is not available.

Step 2: Create Access Token

You need to create an HTTP access token for Qodo to communicate with Bitbucket Data Center.

(Optional) Create a dedicated service account For better visibility and auditability, consider creating a dedicated system administrator user (for example, Qodo) before generating the token. All pull request comments will appear under this user’s name.

1. Log in to Bitbucket Data Center as a system administrator.

2. Click Profile picture → Manage account → HTTP access tokens.

3. Click Create token.

4. Configure the token with the following settings:

   • Name: Qodo Integration

   • Permissions: Repository write access (minimum required)

5. Click Create. Copy and save the bearer token immediately—you will not be able to view it again.

Qodo app enabled in Manage Apps

Step 3: Create a shared webhook secret

Select a strong secret value (it can be any string). You can use any secret generation tool you prefer.

Step 4: Configure the Qodo App in BBDC

1. Navigate to Administration → Add-ons → Qodo

2. Select the Qodo Merge tab

3. In the Connection section, enter:

   • Single Tenant Qodo Merge URL: Your Qodo Merge instance URL provided by your Qodo Account manager.

   • Shared Webhook Secret: The webhook secret you create in step 3.

Step 5: Configure repository integration

Select how Qodo integrates with your repositories.

Integration modes:

• All repositories (default): Qodo is active on all repositories

• Selected repositories only: Choose specific repositories to integrate

• All repositories except: Exclude specific repositories from integration

In the Qodo app configuration:

1. Navigate to the Repositories section.

2. Select your preferred integration mode.

3. If using a selective mode, specify the relevant repositories.

4. Save your changes.

Step 6: Send Bitbucket App Details to Qodo

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

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

Production Note: For production environments, follow your organization's secret management procedures to securely store these credentials.

You’re all set. Wait for the Qodo team to confirm that the installation was successful.

Verification

After receiving confirmation from the Qodo team, you can test the installation.

Test the connection

1. Navigate to Administration → Add-ons → Qodo.

2. Select the Qodo tab.

3. In the Connection section, click Test Connection.

Run a test pull request

1. Open a new pull request in one of the integrated repositories.

2. Qodo should automatically post a review response on the pull request.

Alternatively, add a comment such as /improve to an existing pull request to trigger a review manually.

Verify that Qodo responds with code suggestions and review feedback.

Troubleshooting

If Qodo is not responding:

• Verify that the app is enabled under Settings → Manage apps.

• Check that the repository matches your selected integration mode.

• Confirm that the bearer token has the required permissions.

• Verify that the webhook secret matches in both Bitbucket Data Center and Qodo configuration.

• Review the Qodo logs for connection or authentication errors.

Available commands

Once installed, you can use the following commands in pull request comments:

• /review – Perform a code review

• /improve – Suggest code improvements

• /describe – Generate a pull request description

• /ask – Ask questions about the code changes