Git Connection

Overview

Connecting your Git organization is the foundation for Fly’s automation and visibility. The GitHub App integration allows Fly to monitor your repositories, track workflow activity, and provide complete traceability from code to artifacts.

Supported Platforms

Currently, JFrog Fly supports:

Source Control

  • GitHub - Full integration with repositories and workflows

CI/CD

  • GitHub Actions - OIDC-based CI/CD automation

Additional platforms will be supported in future releases.

Connection Process

Step 1: Initiate Connection

From the Fly Web App, you’ll be guided through a GitHub App authorization flow:

  1. Click the prompt to connect your GitHub account
  2. Authorize Fly to access your GitHub organization
  3. Select the repositories you want to connect

Step 2: Repository Selection

You have two options when selecting repositories:

  • Benefits:
    • Zero friction when creating new projects
    • Automatic tracking of all current and future repositories
    • No need to reconnect when adding new repositories
  • Best For: Teams that want complete automation

Option 2: Select Specific Repositories

  • Benefits:
    • Granular control over which projects use Fly
    • Selective integration for teams with mixed workflows
  • Best For: Teams that want to start small or have specific requirements

What Happens After Connection

Once connected, Fly immediately begins:

  1. Tracking Repositories - Monitoring connected repositories for artifacts and releases
  2. Detecting Workflows - Identifying GitHub Actions workflows for potential integration
  3. Providing Visibility - Displaying repository status in Fly Web

Managing Connections

Updating or Reconnecting Repositories

To update your repository selection or reconnect your GitHub organization:

  1. Navigate to the Git Repositories page in Fly
  2. Click Manage Org & Repositories to update which repositories are connected
  3. You’ll be redirected to manage your GitHub organization settings
  4. Update repository access permissions as needed
  5. Once completed, Fly will automatically sync with the changes

You can also manage repository access directly from your GitHub organization settings:

  1. Go to your GitHub organization settings
  2. Navigate to the JFrog Fly GitHub App
  3. Update repository access permissions
  4. Fly will detect and sync the changes automatically

Repository Configuration Status

After connection, repositories will show one of two statuses in Fly Web:

  • Configured - At least one workflow in the repository is integrated with Fly
  • Not Configured - Repository is connected but workflows need configuration

Learn more about configuring workflows in the Workflow Configuration Section.

Security & Permissions

The GitHub App integration requests minimal permissions:

  • Repository access - Read repository metadata and workflow files
  • Workflow access - Enable Fly integration in GitHub Actions
  • Commits, PRs, and Issues access - Link commits, pull requests, and issues to releases for complete traceability and enable Fly release intelligence

Troubleshooting

Repository Not Appearing

  • Ensure you selected the repository during the GitHub App installation
  • Click Reconnect Your Org to sync the latest repository list
  • Verify you have admin access to the repository

Connection Failed

  • Check that your GitHub account has organization admin permissions
  • Ensure your organization allows third-party GitHub Apps
  • Try disconnecting and reconnecting the integration

Next: Install the Fly Desktop App →