Connect with Bitbucket Server
Connecting with Bitbucket Server grants buddybuild access to your repository so that it can build your app when you push code to your repository. Connecting also grants buddybuild API access to manage webhooks for you, generate commit status, enables the pull request flow, synchronizes access control for team management and more.
Each member of your team that uses buddybuild should go through this guide to connect with Bitbucket Server. This is encouraged so that you can take advantage of team management features.
Buddybuild rejects connecting to repositories via HTTPS that are provisioned with self-signed certificates.
Using a self-signed certificate could make it possible for someone to spoof your repository and inject malicious code into your builds.
Quick links: Connect with Bitbucket Server in 3 easy steps!
Step 1: Install the buddybuild add-on from the Atlassian Marketplace
The following one-time setup must be done as a Bitbucket Server system administrator.
From the Bitbucket Server dashboard click on the Administration setting cog.
Under the Add-ons section, select Find new add-ons.
Next, search for buddybuild and click Install.
The add-on should take a few seconds to install. Once the installation is complete, you’ll see the following message.
You can choose to remove the installation at any time by clicking Uninstall on the Manage add-ons page.
Step 2: Generate your personal access token
Visit the buddybuild plugin settings page by clicking on buddybuild in the left hand navigation. (You may need to refresh the page for this link to appear if you have just installed the plugin).
Under the section Getting started, click on Connect Personal Access Token.
Next, generate your personal access token by clicking on Generate token.
Copy your personal access token and follow step 3 below to connect your Bitbucket Server repository with buddybuild.
Step 3: Connect your Bitbucket Server account
To connect your Bitbucket Server account, launch the buddybuild dashboard and Add a New App.
Next, select Connect another source code provider.
Select Bitbucket Server.
Next, enter your Bitbucket Server endpoint and the Personal Access token you generated in step 2, and click Connect your Bitbucket Server repository.
More about your Bitbucket Server endpoint and personal access token
Your Bitbucket Server endpoint is the hostname part of the URL when you
visit your repositories in Bitbucket Server. Copy the hostname part of
your Bitbucket Server server URL, which often looks something like
Do you have a private DNS?
Do you have a firewall configured?
Create a personal access token
The dialog should close and display a list of your repositories. At this point you have successfully completed connecting buddybuild with Bitbucket Server!