Install the Bitbucket Data Center integration for Qodo on-premises

​

Prerequisites

• Access to your Qodo portal.
• A Qodo environment configured for Bitbucket Data Center.
• Bitbucket System Administrator access, or access to an administrator who can create a dedicated Qodo account and webhooks for you.

​

Access the Bitbucket Data Center integration

​

Install Qodo on Bitbucket Data Center

• Automatic setup (Recommended)
• Manual setup

Qodo creates and configures the account for you.

1

Connect Bitbucket

Enter your server URL, for example https://bitbucket.example.com.Enter your administrator username and administrator password. Qodo uses them once to:

• Create a dedicated Qodo account in your Bitbucket server.
• Give it access only to the projects or repositories you select in the next step.
• Configure the required webhooks for your selected projects or repositories.

Optionally, click Test connection to verify the server and sign-in before continuing.

Qodo doesn’t store your administrator credentials after setup. They’re used only to create the account and configure webhooks, and you can change the password afterward.

Click Continue.

2

Choose repositories

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 added later.
• Selecting an individual repository includes only that repository.

Click Connect repositories.

3

Finish setup

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.

Your Bitbucket administrator creates the account instead of sharing administrator credentials with Qodo.

1

Connect Bitbucket

Enter your server URL, for example https://bitbucket.example.com.Ask your administrator to:

• Create a new Bitbucket user account for Qodo. The username must contain qodo (for example, qodo-bot, svc-qodo, or qodo_reviewer). Qodo rejects a username without it.
• Give this user write access to the projects or repositories you want Qodo to access.
• Share the account’s username and password with you.

Enter the account’s username and password, then click Test connection to verify.

Possible errors

If the connection isn’t verified, the cause is usually one of the following:

• Wrong credentials: Bitbucket rejects the sign-in. Double-check the username and password and try again.
• Username doesn’t contain qodo: Qodo rejects the account. Use a username that contains qodo and try again.

Click Continue.

2

Choose repositories

Select which projects or repositories Qodo should review. You create the webhook for them yourself on the next step.

• 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 added later.
• Selecting an individual repository includes only that repository.

Click Connect repositories.

3

Finish setup

Bitbucket requires additional permission to create webhooks beyond what the connected account has. Create the webhook yourself in Bitbucket, using the values Qodo provides here.

• To connect a whole project: go to Project settings > Webhooks > Create webhook.
• To connect a single repository: go to Repository settings > Webhooks > Create webhook.

Configure the webhook with the following values:

• URL: Paste the URL Qodo displays into the webhook URL field.
• Secret: Paste the secret Qodo displays into the webhook secret field, copied exactly as shown. Qodo uses it to verify that webhook events came from your Bitbucket server.
• Events: Under Pull request, enable Opened, Modified, Source branch updated, Merged, Declined, and Comment added. Under Repository, enable Push.

Once the webhook is created, Qodo starts receiving pull request and repository events from Bitbucket.

A project-level webhook automatically covers all repositories in that project, including ones added later. Project-level webhooks require Bitbucket 8.8 or later. On older versions, create a webhook for each repository instead.

• Click Done.

Qodo uses the Bitbucket account you created to access repositories and post reviews. If you change that account’s password in Bitbucket, reconnect this server in Qodo with the new password.

​

What happens after you connect

• Repository sync: Syncs each connected repository with Qodo.
• Pull request indexing: Indexes each repository’s pull request history.
• Cross-repo discovery: Finds relationships between your repositories.

​

Verify the installation

​

Next steps

• Repositories page: Manage which repositories Qodo is active on, or remove an installation.
• Trigger a code review: Run a review automatically or on demand.