Skip to main content

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.

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.

​
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.
  • 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.
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.
Bitbucket Data Center Manage Apps page showing Upload app option

​
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 if the latest app version compatible with your BBDC instance is not available.
Bitbucket Data Center Manage Apps showing Qodo app enabled

​
Step 2: Create an access token

You need to create an HTTP access token for Qodo to communicate with Bitbucket Data Center.
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.
Bitbucket Data Center HTTP access tokens page showing created token

​
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 Bitbucket Data Center

1
Navigate to Administration → Add-ons → Qodo.
2
Select the Qodo Merge tab.
3
In the Connection section, enter:
  • Qodo on-premises URL: Your Qodo instance URL.
  • Shared Webhook Secret: The webhook secret you created in Step 3.
Bitbucket Data Center Qodo app Connection section with URL and webhook secret fields

​
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.
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.
Bitbucket Data Center Qodo app Repositories section showing integration mode options

​
Step 6: Configure your Qodo instance

Add the following credentials to your Qodo on-premises configuration: 
# 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"
For production environments, follow your organization’s secret management procedures to securely store these credentials.

​
Verify the installation

​
Test the connection

1
Navigate to Administration → Add-ons → Qodo.
2
Select the Qodo Merge tab.
3
In the Connection section, click Test Connection.
Bitbucket Data Center Qodo app Connection section with Test Connection button

​
Run a test pull request

1
Open a new pull request in one of the connected repositories and confirm Qodo is triggered automatically.
2
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.

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

​
What’s next

View Using Qodo in PRs to learn about next steps and how to get the most out of Qodo.