Bulk importing repos via SSH

Tags: Flow

This is a step-by-step guide for adding multiple repos to Flow via SSH. If you only need to import a single repo, check out Importing a repo via SSH.

Flow only has access to commit data for repos connected to Flow through the Generic Repo SSH integration. No ticket, PR, or merge data shows in Flow for these repos.

Important: Use a service account when bulk importing repos via SSH. Learn more about creating a service account.


Bulk importing

  1. Click Add Integration in the top right corner of the Integrations page.  On the following page, select Generic Repo from the Integration Provider list and click Next.
  2. On the next screen, under the SSH tab, click Bulk import.
  3. Prepare a .csv file with a list of all of the SSH clone URLs of the repos you want to import.

The Bulk import modal provides two ways of generating a SSH key required for importing your .csv file:

  • Share SSH keys with a repo you already imported.
  • Generate a new key that can be shared across all the repos you want to bulk import.

Share a SSH key with a repo you already imported

If you already have repos imported via SSH, this is the easiest way to connect your new repos for your bulk import.

  1. Select any repo from the dropdown menu in the modal.
  2. Click Choose File to locate your .csv file.
  3. Click Test connection.

If your connection wasn't successful, you'll receive an error message prompting you to download the list of failed repos to understand why they weren't imported. Follow the troubleshooting prompt and try again.

Here are a few reasons why some of your repos might fail to import:

  • Clone URL is incorrect
  • Repo is already imported
  • SSH key was not added at the user level of your account

back to top


Generate a new key that can be shared across all the repos you're about to bulk import

If you don't have any repos already imported via SSH, you'll need to generate an SSH key.

  1. Click Get Keypair, then click Copy public key to your clipboard. Add the SSH key to your Git host and click the checkbox next to I installed the key.
  2. Click Choose File to locate your .csv file.
  3. Click Test connection. If your connection wasn't successful, you'll see an error message prompting you to download the list of failed repos to understand why they weren't imported. Follow the troubleshooting prompt and try again.

Note: Add the SSH key at the user level, not the repo level.

Here are a few reasons why some of your repos might fail to import:

  • Repo is already imported
  • SSH key wasn't added at the user level of your account

back to top


Finish your connection

  1. If your connection and repos were successfully added, click Next
  2. On the next screen, select the services you want turned on for this integration. For SSH imports, repo services is your only option. Ensure the repo service toggle is on and click Next.
  3. Name your integration. Click Create.

back to top


If you need help, please contact Pluralsight Support.