Install Qodo on Bitbucket Cloud

​

Prerequisites

• Access to your Qodo portal.
• A Qodo environment set up for Bitbucket Cloud. If you’re unsure of your environment type, contact your Qodo Account Manager.
• System administrator access to your Bitbucket workspace.
• A dedicated email address to use for the Qodo Bitbucket account (for example, qodo@yourcompany.com). The account is created during the installation wizard.

​

Access the Bitbucket integration

​

Install Qodo on Bitbucket Cloud

1

Before you begin

You must have system administrative access in your Bitbucket workspace to complete the setup.

1. Create a dedicated Qodo email in your company domain (e.g., qodo@yourcompany.com) to be used to create a Qodo Bitbucket account.
2. Click Next to proceed.

2

Add Qodo to Bitbucket

Using the email you just created, add Qodo as a user in your Bitbucket workspace.

• Click Download Qodo logo for avatar and save it for use in sub-step 3.

Complete the following steps in Bitbucket:

1

Invite user

Go to Workspace settings → User groups, open Add workspace members, and enter the Qodo email address.

2

Create account

Accept the invitation email to create the Qodo Bitbucket account.

3

Log in with Qodo to Bitbucket

Log in to Bitbucket using the Qodo account credentials.

Back in the wizard, select the Confirm Bitbucket Qodo account creation checkbox, then click Next.

3

Install Qodo

Using the Qodo Bitbucket account you just created, install the Qodo app.

Requirements

• The Qodo user must be a Bitbucket workspace admin or repo admin to complete the installation.
• The Qodo user must be logged in to your Bitbucket workspace.

If Qodo has access to more than one workspace, select the workspace to install Qodo on.

• Click Install Bitbucket App to proceed.

4

Add workspace access token (optional)

This step is optional. Skip it to keep using the previously authorized Bitbucket account. If a workspace access token is already saved and this field is left empty, it’s replaced with the authorized account.

If you’re using Bitbucket Cloud Premium, you can add a workspace access token instead. It’s recommended for workspaces with many repositories: it gives Qodo higher API limits and reduces the chance of Bitbucket rate limiting or blocking requests.

Create a workspace access token in Bitbucket.

1. Sign in as the Qodo user created during installation.
2. Go to Workspace settings → Security → Access tokens.
3. Create a token with Repositories, Pull requests, and Webhooks access.

See How to create a workspace access token.Then, back in the wizard, fill in:

• Workspace access token (optional): Paste the token you created.
• Expires on (optional): Add the token’s expiry date. Bitbucket doesn’t expose this date. Enter it here to get a warning before reviews stop. Qodo can’t renew the token automatically.
• Click Continue to proceed.

5

Select repositories

Select the repositories for Qodo to review.

Use the search bar to find specific repositories, or browse by workspace and project. You can select individual repositories or an entire workspace.

• Click Setup to continue.

You can always add more repositories later by returning to this step.

6

Check connection

Qodo verifies the connection to each repository selected in the previous step.

Each selected repository is listed with its installation status.

• Click Next to continue.

7

Setup complete

Qodo has been installed on your Bitbucket workspace. Repositories are fully connected and active within a few minutes.

The confirmation screen shows the number of repositories that will be active once the connection is finalized, and confirms that AI code review, auto rule generation, and codebase context are included.

• Click Done to finish.

​

Verify the installation

​

Next steps

• Repositories page: Enable or disable Qodo on individual repositories within your current scope.
• Trigger a code review: Run a review automatically or on demand.