Skip to main content
Qodo works directly with Bitbucket Data Center, using a dedicated Bitbucket user (qodo-bot) to post code review comments on pull requests. Qodo creates this account automatically using administrator credentials you provide during setup, then discards them. It relies on project-level webhooks to deliver automated insights. You can configure Qodo for selected projects or across your entire Bitbucket Data Center server. Configuration typically takes around 5 minutes. Once installed, Qodo automatically processes pull requests and delivers actionable insights, such as code reviews, descriptions, and improvement suggestions, directly within your Bitbucket workflow.

​
Prerequisites

Before you begin, ensure you have:
  • Access to your Qodo portal.
  • A Qodo environment configured for Bitbucket Data Center.
  • Bitbucket System Administrator access, to sign in and complete setup.

​
Access the Bitbucket Data Center integration

1
Log in to your Qodo portal.
2
Navigate to Integrations.
3
Select the Self hosted tab, locate the Bitbucket Data Center card, and click Add installation to launch the installation wizard.

​
Install Qodo on Bitbucket Data Center

1

Before you begin

A Bitbucket administrator username and password are required to complete this setup.Qodo uses this sign-in once to:
  • Create a dedicated Qodo user (qodo-bot)
  • Register the required webhooks
qodo-bot receives a Licensed User role and write access (PROJECT_WRITE or REPO_WRITE), limited to the projects and repositories you select. Write access lets it post pull request descriptions; it doesn’t grant repository or project administrator permissions.
Your credentials are never stored. You can change the administrator password immediately after setup completes; reviews continue running on the qodo-bot account. An administrator sign-in is required again only if you delete the installation, to remove the webhooks qodo-bot created.
Click Continue.
2

Connect your server

Enter your Bitbucket Data Center server URL and administrator credentials.
1
Enter your server URL, for example https://bitbucket.example.com.
2
Enter your administrator username and administrator password.
Your password is never stored, and is discarded as soon as setup finishes. Bitbucket requires a password rather than a token to create a user.
3
Optionally, click Test connection to verify the server and sign-in without creating the Qodo account or webhooks. On success, Qodo confirms the server is reachable, the sign-in is accepted, and the account has administrator permissions.
4
Click Connect to Bitbucket.
3

Select repositories

1
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 created later.
  • Selecting an individual repository includes only that repository.
2
Click Connect repositories.
4

Install Qodo

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.
Qodo is now active on the repositories in the projects you selected. To add more projects, return to this wizard at any time and run a new installation with the updated scope. Projects that already have Qodo installed are not available for selection. To reduce scope, remove the installation and create a new one.

​
Verify the installation

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.

​
Next steps