Configuring Git SSH on Windows

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community


SSH overview

You can use SSH keys to establish a secure connection between the Bamboo server and the SCM that hosts Git repositories.

  • If no Git capability is configured, Bamboo will use its built-in Git implementation: the built-in Git implementation does not support symbolic links, submodules, automatic branch detection and automatic merging.
  • Your SCM administrator must have already enabled SSH access to Git repositories. 
  • Supported key types are DSA and RSA2. Note that RSA1 is not supported. We've tested key sizes of 768, 1024, 2048, 4096 and 8192 bytes.

On this page:


Enabling SSH access to Git repositories

To enable SSH access:

You need to set up SSH access when you configure your linked repositories:

  1. Click the  icon in the Bamboo header and choose Overview.
  2. Click Linked repositories (under 'Build resources')
  3. Click Add repository, and select Git from the Source repository menu
  4. Complete the following fields:

    Display nameThe name that identifies the repository when you are using multiple repositories in a plan
    Repository URLThe URL of the Git repository
    BranchThe name of the branch or tag containing the source code
  5. Select SSH private key from the Authentication Key menu
  6. Select the file containing your SSH key using the 'Choose File' button
  7. Enter the passphrase to allow access to your SSH key
  8. Click Save repository

Once you have enabled SSH access, you will also need to add an SSH server capability:

  1. Click the  icon in the Bamboo header and choose Overview.
  2. Click Server capabilities and scroll to the bottom of the page
  3. Click Add under the 'Add capability' heading
  4. Complete the following fields:

    Capability typeGit
    PathThe path to the SSH executable, for example: /usr/bin/ssh
  5. Click Add to add the SSH capability.


Last modified on Jul 20, 2020

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.