Skip to main content
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 project read and 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 Admin
  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

CodeRabbit can connect directly to a reachable Bitbucket Data Center instance or through an operator-provisioned CodeRabbit Reverse Tunnel. For a private instance with no public endpoint, contact CodeRabbit Support or Sales to provision the tunnel and connector before onboarding. For a tunnel connection, enter your canonical Bitbucket Data Center URL on the login page and provide the bot token and OAuth credentials when prompted. CodeRabbit validates credentials and makes API requests through the provisioned tunnel. Keep the connector connected during setup. Your browser must still reach the canonical Bitbucket URL for OAuth authorization, and Bitbucket must be able to send outbound HTTPS webhooks to CodeRabbit. Credential updates preserve the provisioned route; contact Support to change the route. If you connect directly and your Bitbucket Data Center instance requires IP allowlisting, add these CodeRabbit IP addresses:

​
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
  • Approved
  • Changes Requested (shown as Needs Work on older Bitbucket Server versions)
  • Unapproved
  • Updated
Bitbucket versions that reject reviewer event subscriptions cannot send reviewer transitions to CodeRabbit, so Triage review state may remain stale.
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

  • Verify the HTTP Access Token has the correct permissions (project read and repository write)
  • Ensure the bot user account is active and not locked
  • Check that your Bitbucket Data Center URL is correct and reachable through the configured connection: directly from CodeRabbit, or through the provisioned reverse tunnel
  • For a reverse tunnel, verify that the connector is connected and can reach Bitbucket Data Center inside your network
  • 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
  • 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
  • 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
  • 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.