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.
Who can use this?
Adding a single repo
Starting on your Flow home page, go to the top navigation bar and click Settings. Using the left navigation under Integrations, click Integrations. Click Add Integration button in the top right hand corner of you integrations screen. On the following page select Generic Repo from the Integration Provider list and click Next.
Click on the SSH tab, input your SSH clone URL then click Get Keypair.
Click Copy public key to your clipboard. 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.
Once you've added your SSH key to your Git host, navigate back to Flow and check I installed the key and click Test connection.
If your connection was not successful, you will see an error message letting you know the probing failed.
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.
If your connection was successful, click Next. 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 toggled on and click Next.
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.
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.
If you need help, please email firstname.lastname@example.org for 24/7 assistance.