> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coderabbit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Bitbucket Data Center

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

<Info>
  For a hands-on tutorial with CodeRabbit performing code reviews on a live repository, see [Quickstart](/getting-started/quickstart).
</Info>

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.

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

## Prerequisites

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

<Steps>
  <Step title="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
  </Step>

  <Step title="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

    <Warning>
      Save the token securely. It will only be shown once.
    </Warning>
  </Step>

  <Step title="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**
  </Step>
</Steps>

## Connect to CodeRabbit

<Steps>
  <Step title="Navigate to the CodeRabbit login page">
    Go to the [CodeRabbit login page](https://app.coderabbit.ai/login?free-trial) and select **Bitbucket Data Center**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Authorize CodeRabbit">
    You will be redirected to your Bitbucket Data Center instance to authorize CodeRabbit. Review the requested permissions and click **Allow**.
  </Step>
</Steps>

## Install CodeRabbit on your repositories

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

<Steps>
  <Step title="Select a project">
    Choose the Bitbucket Data Center project containing the repositories you want CodeRabbit to review.
  </Step>

  <Step title="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
  </Step>
</Steps>

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

## Configure network access

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

```text IPs to allow list theme={null}
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

## Troubleshooting

<AccordionGroup>
  <Accordion title="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
  </Accordion>

  <Accordion title="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
  </Accordion>

  <Accordion title="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
  </Accordion>

  <Accordion title="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
  </Accordion>
</AccordionGroup>

<Info>
  For additional support, visit the [support page](/support).
</Info>

## What's next

<CardGroup cols={1}>
  <Card title="Configure CodeRabbit" icon="settings" href="/getting-started/yaml-configuration" horizontal="true">
    Customize review behavior, language settings, and rules for your repositories.
  </Card>

  <Card title="Code Review Overview" icon="search" href="/guides/code-review-overview" horizontal="true">
    Learn how CodeRabbit reviews your pull requests and provides actionable feedback.
  </Card>

  <Card title="Get Support" icon="life-buoy" href="/support" horizontal="true">
    Reach out to the CodeRabbit team for help with setup or integration issues.
  </Card>
</CardGroup>