This is a step-by-step guide for connecting a single repo to Flow via HTTPS. Flow only has access to commit data for repos connected to Flow through the Generic Repo HTTPS integration. No ticket, PR, or merge data shows in Flow for these repos.
Learn more about Bulk importing repos via HTTPS to add multiple repos at once via HTTPS.
Important: Use a service account when importing repos via HTTPS. Learn more about creating a service account.
To import a repo via HTTPS:
- Click Settings in Flow's top navigation bar.
- In the left navigation under Integrations, click Integrations.
- Click Add Integration in the top right of the Integrations page.
- Click Generic Repo from the Integration Provider list.
- Click the HTTPS tab.
- For private repos, enter your Git host username, password, and the Clone URL for the private repo you want to import.
Tip: If you enabled two-factor authentication in your vendor, the password is replaced with a token. Create a personal access token unique for each git host. For an example, see how to create a token in GitHub (external site, opens in new tab).
Public repos don't require a username and password. Check the public repo box and add your Clone URL to connect to a public repo.
- Click Test connection to verify your credentials and Clone URL.
- If your connection is successful, you'll see a success message.
If your connection wasn't successful, you'll see an error message.
Here are a few reasons your repos might fail to import:
- Clone URL is incorrect
- User name or password are incorrect
- Repo is already imported
- Two-factor authentication is enabled for your Git host. Use a personal access token
- If your connection is successful, click Next.
- Ensure the Repo service is toggled on and click Next.
- Name your integration so you can find it more easily in Flow. Click Create.
Tip: If you imported other repos via HTTPS under another integration, you can assign and consolidate all HTTPS Integrations under one integration for easier management. Learn more about Managing repositories.