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:

    Field Description
    Display name The name that identifies the repository when you are using multiple repositories in a plan
    Repository URL The URL of the Git repository
    Branch The 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:

    Field Value
    Capability type Git
    Executable SSH
    Path The path to the SSH executable, for example: /usr/bin/ssh
  5. Click Add to add the SSH capability.


Last modified on Feb 5, 2019

Was this helpful?

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