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:

Git repository connectivity using SSH under Windows

The Bamboo Developers recommend that you use Cygwin SSH client instead of the SSH client bundled with Git. Cygwin SSH offers significantly improved speed, stability and configuration options over the one bundled with Git.

1. Download the relevant Cygwin packages from cygwin.com
2. Run the executable, selecting the default options until you reach the 'Select package' menu
3. Select the following packages from the menu:
   • git-completion
   • git-gui
   • git-k
   • openssh

Next you need to configure the Cygwin SSH instance.

1. Open the C:\cygwin directory and edit the Cydgwin.bat file in a text editor. Add this line:

   set CYGWIN=binmode ntsec

   before the line that invokes the bash shell

2. Next we will check that Cygwin was correctly installed. Run C:\Cygwin\Cygwin.bat, and run the following command:

   cygrunsrv -h

   This should display a listing of Cygwin help commands. If not, then something has gone wrong and you will need to reinstall Cygwin.

Once you have configured your SSH service, follow the steps described below for enabling access to Git repositories. You will also need to add an SSH capability for each local and remote agent.

Enabling SSH access to Git repositories

To enable SSH access:

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

1. 
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. 
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.