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. In the upper-right corner of the screen, select
    Administration bamboo administration icon
    > Overview.
  2. Under Build resources, select Linked repositories.
  3. Select Add repository, and then select Git from the Source repository menu.
  4. Complete the following fields:

    FieldDescription
    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. Select Save repository.

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

  1. In the upper-right corner of the screen, select
    Administration bamboo administration icon
    > Overview.
  2. Under Build resources, select Server capabilities.
  3. Select Add under the Add capability heading.
  4. Complete the following fields:

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


Last modified on Oct 10, 2023

Was this helpful?

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