Skip to main content

Integrating with Bitbucket Server / Bitbucket Data Center

Deploy to and from Bitbucket Server / Bitbucket Data Center using Gearset

Valerio Chang avatar
Written by Valerio Chang
Updated over 2 weeks ago

As of Feb 15, 2024:

Atlassian has sunset support for their on-premise Server products. This includes security updates and bug fixes for vulnerabilities. Before connecting to an on-premise version of either BitBucket or Jira, check whether your company already has a plan to migrate to the cloud-hosted versions of these products.

Initial Bitbucket Server / Bitbucket Data Center setup (Gearset team-owner only)

First, check that the URL for your Bitbucket Server / Bitbucket Data Center instance is publicly available with a public DNS record for Gearset to connect. You can verify this by entering the instance URL at https://dnschecker.org/.

Then you'll need your Bitbucket Server administrator to create an application link within Bitbucket Server to Gearset. Then you'll need to get your Gearset team owner to link your Gearset team to that Bitbucket Server instance. This provides a mechanism for Gearset to authenticate against Bitbucket Server and only has to be completed once for your team. Once this initial connection has been made, any other users on your team can set up their own Bitbucket Server connection themselves in a couple of clicks.
​

Copy Gearset's public key (Gearset team-owner only)

  1. In Gearset, under My connections, click the Source control and services page.

  2. Click + Connect to Bitbucket Server / Bitbucket Data Center.

  3. In the resulting dialog, get the generated Public key and Consumer key to hand as you'll need them for the next step.

  1. In a new tab, sign in to your Bitbucket Server / Bitbucket Data Center instance as an administrator and navigate to the Administration page then click Application Links from the menu. (Note: this must be completed in a new tab to preserve the generated Consumer key).

  2. Click Create link and choose Atlassian product. Enter https://app.gearset.com in the box and click Continue.

  3. When prompted with a dialog to confirm the application URL, click Continue. The yellow warning can be ignored.

  4. In the Link applications dialog, enter an Application Name, and leave the Application Type  as Generic Application. It's important to leave the Service Provider Name blank and to check Create incoming link before clicking Continue.

  5. In the Link applications dialog, enter a Consumer Name and Gearset’s Consumer Key and Public Key from Step 1. Once the configuration is complete, click Continue.

  6. Once completed, Gearset should appear as an application link in your Bitbucket Server / Bitbucket Data Center instance.

Authorize Gearset as your Bitbucket Server / Bitbucket Data Center user

  1. Switch back to the Source control and services page in Gearset. In the same Add Bitbucket Server dialog as before, enter the URL of your Bitbucket Server / Bitbucket Data Center instance and click Connect.

  2. You’ll be redirected to your Bitbucket Server / Bitbucket Data Center instance and prompted to log in, if you aren’t already. When prompted, grant Gearset permission to make changes to your Bitbucket Server / Bitbucket Data Center data by clicking Allow.

  3. Once complete, you'll be redirected back to Gearset. 

Connecting to Bitbucket Server / Bitbucket Data Center (All team members)

Once the Bitbucket Server / Bitbucket Data Center application link has been created and Gearset has been authorized by the team owner, the rest of the team members will be able to connect to Bitbucket Server.

  1. Navigate to the Source control and services page and click + Connect to Bitbucket Server.

  2. Click Allow within the Welcome to Bitbucket Server dialogue box.

  3. You'll be redirected back to Gearset and can start working with repositories on your Bitbucket Server instance.

Related Articles
Integrating with Jira (Hosted/Cloud)
Integrating with self-managed GitLab
Integrating with GitHub Enterprise Server
Integrating with Azure DevOps Server
Integrating with Bitbucket
Did this answer your question?