README.adoc

titletext	description
Connect your Bitbucket Server repository to buddybuild via SSH	We recommend using buddybuild's integration with the Bitbucket Server API to connect your repository. This section covers connecting via SSH.

Add a Bitbucket Server Repository

If your repository lives in Bitbucket Server (or Stash), you can sign into buddybuild with your email. Buddybuild automatically generates a secure SSH key for you to install into your source control system. Buddybuild uses this key to clone your repository.

{% include "/_common/important-ssh_access.adoc" %}

Let’s get started!

Note	Quick Links Step 1: Enter the SSH Git Clone URL Step 2: Add the SSH Key to Your Bitbucket Account

Step 1: Enter the SSH Git Clone URL

Head over to Bitbucket and find the repository you would like to connect with buddybuild. Within the main page of that repository, look to the top-right for HTTPS URL. Click on the HTTPS dropdown menu and select SSH.

Highlight and copy the SSH URL.

Head back over to buddybuild and paste the SSH URL you copied into the Git Clone URL field.

Step 2: Add the SSH Key to Your Bitbucket Account

Highlight and copy the generated SSH key.

Navigate to your Bitbucket Account by first selecting your account photo, and then selecting Settings.

Select SSH keys.

Next, select Add key.

Enter Buddybuild as the title, and paste the copied SSH key into the key field.

Next, click Add key.

Warning

Private git submodules and private cocoapods If your project depends on any code in other private git repos, the SSH key will need to be added to those repos as well.

Navigate back to buddybuild and click on the Build button.

Buddybuild clones your project code and starts a simulator build. The build should finish within a few minutes.

That’s it! Your Bitbucket Server repository is now connected to buddybuild, and your first build is under way. The next steps are:

• Add a Bitbucket server webhook to automatically notify buddybuild of repository changes.

• invite testers to try out your app.