Bitbucket Data Center

Learn how to integrate CodeRabbit with your self-hosted Bitbucket Data Center instance for AI-powered code reviews on pull requests.

For a hands-on tutorial with CodeRabbit performing code reviews on a live repository, see Quickstart.

CodeRabbit integrates with Bitbucket Data Center to bring AI-powered code reviews to your self-hosted Bitbucket instance:

• Automated code reviews for newly created pull requests
• Intelligent comments and suggestions displayed directly on pull requests
• Real-time bot interaction for immediate feedback and assistance
• Seamless webhook integration for continuous monitoring

This guide walks you through connecting your Bitbucket Data Center instance to CodeRabbit.

To interact with CodeRabbit in pull request comments, use @coderabbitai — or the username of the bot user you create below, if it differs.

Prerequisites

Before starting, you need to set up the following in your Bitbucket Data Center instance:

1. Create a bot user

   Create a dedicated Bitbucket user for CodeRabbit (e.g., “CodeRabbit”). This user will post code review comments on pull requests.

   • Add the bot user to each project where you want CodeRabbit to review pull requests
   • Grant the bot user write permissions on the relevant repositories
2. Generate an HTTP Access Token for the bot user

   Generate an HTTP Access Token for the bot user:

   1. Log in as the bot user
   2. Navigate to Manage Account and select HTTP Access Tokens
   3. Create a new token with repository write permissions

   Save the token securely. It will only be shown once.

3. Create an OAuth consumer

   Create an OAuth consumer in your Bitbucket Data Center administration:

   1. Navigate to Administration and then Application Links
   2. Create a new External application with an Incoming link
   3. Set the Redirect URL to: https://app.coderabbit.ai/login
   4. Grant the following permissions:
      • Repository Read
      • Repository Write
      • Project Read
   5. Note the Client ID and Client Secret

Connect to CodeRabbit

1. Navigate to the CodeRabbit login page

   Go to the CodeRabbit login page and select Bitbucket Data Center.

2. Enter your Bitbucket Data Center URL

   Enter the URL of your Bitbucket Data Center instance (e.g., https://bitbucket.company.com) and click Submit.

   If your instance is already registered, you will be redirected to the OAuth authorization flow. Otherwise, you will be prompted to provide your credentials.

3. Provide credentials

   If this is the first time connecting your instance, provide:

   • Bot Token: The HTTP Access Token you generated for the bot user
   • Client ID: The OAuth consumer Client ID
   • Client Secret: The OAuth consumer Client Secret

   Click Validate token to verify the bot token before proceeding.

4. Authorize CodeRabbit

   You will be redirected to your Bitbucket Data Center instance to authorize CodeRabbit. Review the requested permissions and click Allow.

Install CodeRabbit on your repositories

After logging in, the onboarding wizard guides you through selecting projects and repositories.

1. Select a project

   Choose the Bitbucket Data Center project containing the repositories you want CodeRabbit to review.

2. Select repositories

   • Browse or search for repositories within the selected project
   • Select the repositories where you want to enable AI code reviews
   • Click Install to complete the setup

CodeRabbit will automatically configure webhooks for the selected repositories. Once installed, CodeRabbit begins reviewing new pull requests immediately.

Configure network access

If your Bitbucket Data Center instance requires IP allowlisting, add these CodeRabbit IP addresses:

IPs to allow list

35.222.179.152/32, 34.170.211.100/32, 136.113.208.247/32

Manage credentials

You can update the bot user’s HTTP Access Token at any time:

1. Navigate to Organization Settings in the CodeRabbit app
2. Select the Bitbucket DC User tab
3. Enter the new HTTP Access Token
4. Save your changes

Manual webhook installation

If you install repositories from the CodeRabbit app, CodeRabbit configures the webhook automatically. Use this flow only when you need to install the webhook manually or rotate the shared webhook secret.

The Webhook Secret page is available to Bitbucket Data Center organizations with organization settings access.

1. Open Webhook Secret settings

   In the CodeRabbit app, open Account and select Webhook Secret from the sidebar.

2. Copy the webhook URL

   Use the Webhook URL field on that page to copy the exact endpoint that your Bitbucket Data Center project or repository webhook should call.

3. Save or change the webhook secret

   Enter the secret that Bitbucket Data Center should send with webhook deliveries and save it in CodeRabbit.

4. Configure the Bitbucket Data Center webhook

   When creating or editing the webhook in Bitbucket Data Center, use the copied webhook URL and enable these pull request events:

   • Opened
   • Modified
   • Comment Added

If you change an existing webhook secret, CodeRabbit attempts to update existing CodeRabbit-managed Bitbucket Data Center webhooks across installed repositories automatically and reports how many were updated, skipped, or failed. If a webhook was created manually, or if an automatic refresh fails, update the secret directly in Bitbucket Data Center.

Manually configured Bitbucket Data Center webhooks are validated with the per-repository secret first, then the self-hosted instance-level secret when no per-repository secret is available. For self-hosted deployments, keep BITBUCKET_SERVER_WEBHOOK_SECRET aligned with the secret configured in CodeRabbit; see the Bitbucket Data Center self-hosted .env file.

Troubleshooting

Bot token validation fails

• Verify the HTTP Access Token has the correct permissions (repository write)
• Ensure the bot user account is active and not locked
• Check that your Bitbucket Data Center URL is correct and accessible from the internet

OAuth authorization fails

• Verify the Client ID and Client Secret match the OAuth consumer configured in Bitbucket DC
• Ensure the callback URL is set to https://app.coderabbit.ai/login
• Check that the OAuth consumer has the required permissions

Webhooks not working

• Ensure your Bitbucket Data Center instance can reach CodeRabbit’s servers
• Check webhook configurations in your repository settings
• Verify the bot user has write access to the repositories

Webhook secret mismatch

• Confirm the webhook secret in Bitbucket Data Center matches the value saved on CodeRabbit’s Webhook Secret page
• Update manually created webhooks directly in Bitbucket Data Center after rotating the secret
• Review skipped or failed refreshes reported by CodeRabbit and update those repository webhooks directly
• For self-hosted deployments, confirm BITBUCKET_SERVER_WEBHOOK_SECRET matches the secret configured in CodeRabbit

Reviews not posting

• Confirm the bot user is added to the project with write permissions
• Verify the HTTP Access Token has not expired
• Check that webhooks are properly configured and active

For additional support, visit the support page.

What’s next

Configure CodeRabbit

Customize review behavior, language settings, and rules for your repositories.

Code Review Overview

Learn how CodeRabbit reviews your pull requests and provides actionable feedback.

Get Support

Reach out to the CodeRabbit team for help with setup or integration issues.