Skip to main content

Connecting to Private Repository via SSH

Using Direct SSH Key​

If you use a private repository using an SSH Key, you need to have an SSH key pair ready and enter your private key to Appcircle so Appcircle can access your repository.

caution

For the SSH key field in the repository connection, the private key is required. The public key is entered/stored in the Git provider while the private key is entered in Appcircle.

To generate a new key pair, you can run the following command:

ssh-keygen -t rsa -b 4096 -P '' -f ./appcircle-ssh -m PEM

Two files will be created as appcircle-ssh.pub (Public key) and appcircle-ssh (Private key)

You can then run the cat ./appcircle-ssh command and enter its output to Appcircle and run the cat ./appcircle-ssh.pub command and enter its output to the SSH keys section of the Git provider.

Select Connect via SSH through the connection selection

Then, enter your relevant information to connect to the private repository:

After the connection is successful, you can view your newly created profile and start building!

info

To enable triggered auto builds with webhooks for SSH repository connections, please refer to the following guide: Build Manually or Automatically with Webhooks and Triggers

caution

Connection Notice​

If your SSH server runs on a different port, you should add the port number to your connection string.

ssh://git@mydomain.com:port/path/to/repo.git

For Appcircle to connect to the Self Hosted GitLab Instance, your connection must be reachable over the internet.

Is your self-hosted GitLab instance under an enterprise firewall? Learn which IP addresses and ports Appcircle uses to function under the whitelist documentation:

File IconAccessing Repositories in Internal Networks (Firewalls)

How to connect to AWS CodeCommit repositories through SSH?​

AWS CodeCommit requires the creation of a dedicated user for repository connections through SSH (i.e. the root user cannot be used for this purpose).

  • First, create a user in AWS IAM and assign the following permissions to the user:

  • Go to IAM -> Users -> User -> Security credentials and select "Upload SSH key".
  • Take a note of the SSH key ID generated by AWS as follows:

  • Once you login with the newly generated user and copy the repository URL in SSH format, you will receive URL as follows: ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo
  • For the SSH connection to be initialized, you need to add the public key to your URL to have it in the following format, which then can be entered in Appcircle to be used in SSH connections.ssh://Your-SSH-Key-ID@git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo

Need help?​

Get help from Appcircle's support team, or see how others are using Appcircle by joining our Slack Channel.

Slack
Slack favicon https://join.slack.com/t/appcircleio/signup