Importing a repo via SSH

Tags: Flow


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 Flow home page, go to the top navigation bar and click Settings. Using the left navigation under Integrations, click Integrations.

Step 2: Select the Add Integration button in the top right hand corner of you integrations screen.

Step 3: On the following page select 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: 

  1. Add a descriptive title to remember what the SSH key goes to
  2. Paste the SSH key
  3. Click Add SSH key

You have successfully added your SSH Key!

Step 7: Navigate back to Flow and check I installed the key and click Test connection.

Step 8: If your connection was successful you will see the following message:

If your connection was not successful, you will see an error message like the one below.

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

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, name your integration. Click Create.

Tip: If you have other repos that were imported via SSH under another Integration, you will be able to assign and consolidate all SSH Integrations under one. See Managing repositories for more information.

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 link under the Repos tab on your integration page. To learn more about managing your new integration settings, see Managing integrations.

back to top

If you need help, please email for 24/7 assistance.