Skip to main content
Contact Support

Bulk importing repos via SSH

Tags:

Note: SSH repo ingestion is only available in Flow Enterprise Server. Use an alternate integration method if you use Flow Cloud.

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.

back to top

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 SSH key

If you don't have any repos already imported via SSH, you'll need to generate an SSH key that can be shared across all the repos you're about to bulk import.

  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.

Related articles