Skip to main content

Connect Bitbucket (Cloud or Server) to LinearB

Connect Bitbucket to LinearB to sync repositories, commits, branches, and pull requests. This data powers core delivery metrics and (optionally) automation workflows. Overview. LinearB supports: Bitb…

Steven Silverstone
Updated by Steven Silverstone

Connect Bitbucket to LinearB to sync repositories, commits, branches, and pull requests. This data powers core delivery metrics and (optionally) automation workflows.

Overview

LinearB supports:

  • Bitbucket Cloud (Atlassian-hosted)
  • Bitbucket Server / Data Center (self-hosted / on-prem)

After you connect Bitbucket and select repositories, LinearB begins ingesting Git activity and backfills historical data. Backfill duration depends on repository size and history.

Before you begin

  • LinearB: Company Admin permissions
  • Bitbucket Cloud: Ability to authorize applications and access the repositories you want to connect
  • Bitbucket Server: Ability to create a Personal Access Token (PAT) and access the Bitbucket Server URL
Security note:
LinearB uses read-level access to analyze Git history and metadata. It does not modify your code, branches, or pull requests.

Estimated time: Bitbucket Cloud (5–10 min) • Bitbucket Server (10–20 min, plus any network changes)

Bitbucket Cloud

Connect Bitbucket Cloud

Step 1 — Add the Bitbucket Cloud integration

  1. In LinearB, go to Settings → Company Settings → Git.
  2. Click Add Integration.
  3. Select Bitbucket (Cloud).

Step 2 — Authorize LinearB in Bitbucket

  1. In LinearB, click Continue to open the Bitbucket authorization flow.
  2. Sign in to Bitbucket if prompted.
  3. When asked to grant access, click Grant access.
Note:
In some flows, you may see two login prompts. One links your LinearB user account; the second connects your Bitbucket account.

Step 3 — Select repositories

  1. Open the Bitbucket integration in LinearB.
  2. Click Add repositories.
  3. Select the repositories you want LinearB to follow, then click Save repositories.

Only repositories that are not already connected through another Git integration will appear for selection.

Bitbucket Server / Data Center (On-Prem)

Note: Bitbucket Server / Data Center integrations are available on paid LinearB plans.

Connect Bitbucket Server / Data Center

Step 1 — Add the Bitbucket Server integration

  1. In LinearB, go to Settings → Company Settings → Git.
  2. Click Add Integration.
  3. Select Bitbucket Server.

Step 2 — Ensure LinearB can reach Bitbucket Server

If your Bitbucket Server instance is accessible from the public internet, you can skip this step. If it is hosted in a private network, allowlist LinearB’s public IP addresses in your firewall or reverse proxy:

  • 52.15.80.85
  • 13.56.203.235
  • 54.151.81.98
  • 18.118.232.229

Step 3 — Enter the Bitbucket Server URL

  1. Enter your Bitbucket Server URL in the LinearB setup screen.
  2. Wait for LinearB to validate connectivity.
  3. Click Continue.

Step 4 — Create a Personal Access Token (PAT)

  1. Log in to your Bitbucket Server / Data Center instance.
  2. Go to Manage Account → Account Settings → Personal Access Tokens.
  3. Click Create a token, give it a descriptive name, and select the required Read permissions.
  4. Click Create, then copy the token (you will not be able to view it again).

Step 5 — Connect and select repositories

  1. Return to LinearB.
  2. Paste the PAT into the token field.
  3. Click Connect to validate the token.
  4. When prompted, select the repositories LinearB should follow.

Verify

Use the checks below to confirm the integration is working.

  • In LinearB, go to Settings → Company Settings → Git and confirm the integration shows Connected.
  • Open the integration and confirm the expected repositories are listed.
  • After initial processing, pull requests and commits from those repositories begin appearing in LinearB views.

Troubleshooting

Problem Likely cause Fix
Bitbucket Server connection fails Bitbucket Server is not reachable from LinearB Verify the Bitbucket Server URL and confirm LinearB IPs are allowlisted in your firewall or reverse proxy.
Some repositories are missing in LinearB Access permissions are missing, or repositories were not selected Confirm the Bitbucket account/token has access to the repos, then open the integration and click Add repositories.
Token rejected (Bitbucket Server) PAT lacks required read permissions or was copied incorrectly Regenerate the PAT with the necessary read permissions and paste the new value into LinearB.
Updates appear delayed Network restrictions interfere with connectivity Confirm LinearB can reach Bitbucket Server consistently (allowlist IPs, verify reverse proxy rules).

FAQs

Which option should I choose: Bitbucket Cloud or Bitbucket Server?
Use Bitbucket Cloud if your repositories are hosted on Atlassian’s managed platform. Use Bitbucket Server / Data Center if repositories are hosted on your own infrastructure.

Can I connect multiple Git providers?
On paid LinearB plans, you can add multiple Git integrations (for example, Bitbucket + GitHub + GitLab) from Settings → Company Settings → Git.

Do I need to connect all repositories?
No. Connect only the repositories that are relevant for the teams and metrics you want to track.

Done?
Once Bitbucket is connected and repositories are selected, return to the Enterprise Setup Guide and continue to the next step in Phase 1.

How did we do?

Contact