Skip to main content

Self-Hosted Bitbucket Integration

Step 1 — Create an OAuth Consumer in Your Bitbucket Server​

Requirements: Administrator (or Project Admin) access to your Bitbucket Server/Data Center instance with OAuth consumers enabled.

  1. Log in to your Bitbucket instance (e.g., https://bitbucket.yourcompany.com).
  2. Navigate to Administration → Applications → OAuth (or Settings → Application Links, depending on your version).
  3. Click Create OAuth Consumer.
  4. Fill out the form:

    • Application Name: GitMe Performance Tracking

    • Callback URL (Redirect URL):

      https://backend.gitdotme.com/bitbucket/callback

    • Permissions: Enable read-only permissions exactly as shown:

      • Account: Read (Email optional)
      • Workspace membership: Read
      • Projects: Read
      • Repositories: Read
      • Pull requests: Read
      • Pipelines: Read

    • Leave all other permissions unchecked — GitMe does not require write/admin/delete access.

  5. Choose a Consumer Key (e.g., gitme-perf-tracking).
  6. Save the form to generate your Shared Secret.
  7. Copy the Consumer Key, Shared Secret, and Application Name (Consumer Name) for the next step.

Step 2 — Connect Your Bitbucket Server to GitMe​

  1. In GitMe, open the Self-Hosted Bitbucket Integration section.
  2. Enter:
    • Bitbucket Server URL (e.g., https://bitbucket.yourcompany.com)
    • Consumer Key
    • Shared Secret
    • Consumer Name
  3. Click Connect with Self-Hosted Bitbucket.

Step 3 — Authorize GitMe in Bitbucket​

  • After clicking the connect button, you will be redirected to your company’s Bitbucket instance.
  • Review the access request screen (read-only permissions) and click Grant Access.
  • GitMe is now allowed to read repository metadata and commit information.

Step 4 — Complete Onboarding & Select Repositories​

  • After authorization, you’ll be redirected back to GitMe.
  • Provide your Company Name, Full Name, and Email.
  • Repository Selection:
    • GitMe loads the repositories you can read.
    • Repositories are selected by default — uncheck any you do not want GitMe to analyze.
    • This ensures you control which codebases are monitored.

Step 5 — Accept the Agreement​

  1. Review the GitMe agreement.
  2. Check "I have read and accept the agreement."
  3. Click Get Started.

Step 6 — Choose Your Plan​

  • Select the subscription plan that fits your organization’s needs.
  • GitMe begins analyzing your selected repositories and generating developer effort insights.
warning

⚠️ Network Requirements

To integrate successfully, ensure the following connectivity:

  1. Outbound Access (Bitbucket → GitMe): Your Bitbucket Server must reach https://backend.gitdotme.com (for OAuth token exchange).
  2. Inbound Access (GitMe → Bitbucket): GitMe’s cloud service must reach your Bitbucket API (e.g., https://bitbucket.yourcompany.com/rest/api/1.0/) to fetch repositories and commits.
  3. Webhooks (Recommended): Bitbucket should be able to POST events to https://backend.gitdotme.com/bitbucket/webhook.