Importing a Repo via SSH
Below is a step-by-step guide for adding a single repo via SSH. If you're interested in importing more than one repo, check out Bulk Importing Repos via SSH.
Adding a Single Repo
Step 1: Starting on your GitPrime Home page go to the left navigation bar. At the bottom go to Settings then select Integrations.
Step 2: Select the button in the top right hand corner of your Integrations screen.
Step 3: On the following page select the Generic Repo from the Integration Provider list and click Next.
Step 4: Click on the SSH tab, input your SSH clone URL then click Get Keypair.
Step 5: Click Copy public key to your clipboard.
Step 6: Add the SSH key to you Git host. Please add the SSH key at a user or organization level, as opposed to the repo level. This will allow the key to be shared with other repos added via bulk SSH in the future.
To do this, go to your Git host Settings (this example is from GitHub; other host’s UI will vary).
Select SSH and GPG keys from the left navigation, then click New SSH Key.
On the next screen you will need to:
- Add a descriptive title to remember what the SSH key goes to
- Paste the SSH key
- Click Add SSH key
You have successfully added your SSH Key!
Step 7: Navigate back to GitPrime and check I installed the key and click Test connection.
Step 8: If your connection was successful you will see the following message:
Here are a few reasons why a repo might fail to import:
- The SSH clone URL is incorrect.
- The SSH key was not placed at the user level of your Git host.
Please allow a couple hours to a day, depending on the size of the repo and the commits, for your repo to fully process. Commits are processed in reverse chronological order during this time.
If you are still having issues, email us at email@example.com or click on the chat link in the bottom right corner of your screen.
Step 9: If your connection was successful, click Next.
Step 10: On the next screen you will be selecting the services you want turned on for this Integration. For SSH imports, repo services is your only option. Ensure the repo service is “On” and click Next.
Step 11: Next, you will want to name your Integration. In this example we named it “Repo Imported via SSH”. Click Create.
Step 12: You have successfully created a new Integration and imported your repo via SSH.
Step 13: To view your imported repo click on the Find your imported repos here link under the Repos tab on your Integration page. To learn more about managing your new Integration settings, see Managing Integrations.
Want someone from our team to walk you through importing via SSH? Email us at firstname.lastname@example.org or click on the chat icon in the bottom right corner of your screen.