Managing Git Integrations

• View all Git integrations and repository monitoring counts.
• Search and filter discovered repositories.
• Monitor or unmonitor repositories directly from the Git integration page.
• Reauthorize, configure monitoring rules, or delete existing integrations.
• Upgrade eligible GitHub OAuth or Classic Token integrations to the LinearB GitHub App.
• Manage gitStream connections.
• Add new Git integrations at any time.

1. Go to Settings → Company Settings → Git.
2. Under Integrations and Repositories, locate the integration you want to manage.
3. Click the integration row to expand its details.
4. Click the vertical ellipsis (⋮) to access available actions:
   • Reauthorize Git — Refresh authentication if the token expired or permissions changed.
   • Monitoring Rules — Control which repositories, pull requests, or branches LinearB monitors.
   • Upgrade to GitHub App — Upgrade an eligible GitHub OAuth or Classic Token integration to the LinearB GitHub App without creating a new integration. This action is available only to LinearB admins and appears only for eligible integrations.
   • Delete Integration — Permanently remove the integration.

LinearB admins can upgrade existing GitHub integrations that use OAuth or a Classic Token to the LinearB GitHub App.

The upgrade happens within the existing integration. You do not need to create a new integration, and your repository settings and monitoring rules are preserved.

Eligibility requirements

The Upgrade to GitHub App option appears only when the following conditions are met:

• The integration uses GitHub OAuth or Classic Token authentication.
• The integration contains only one GitHub organization.
• The integration has fewer than 1,000 monitored repositories.

Repositories in the Monitored, Processing, and Failing states all count toward the 1,000-repository limit.

Integrations with 1,000 or more monitored repositories, or with more than one GitHub organization, cannot be upgraded using this option.

Upgrade procedure

1. Navigate to Settings → Company Settings → Git → Integrations and Repositories.
2. Locate your existing GitHub integration.
3. Open the vertical ellipsis (⋮) menu and select Upgrade to GitHub App.
4. Review the confirmation dialog and click Upgrade to GitHub App.
5. LinearB redirects you to GitHub. Install the LinearB GitHub App in the GitHub organization connected to your existing integration. If you do not have the required GitHub permissions, request approval from a GitHub organization administrator.
6. Under Repository access, select All repositories.
7. Complete the GitHub App installation and return to LinearB.

What happens to existing settings?

• Repository settings and monitoring rules: All existing settings and monitoring rules are preserved.
• Webhooks: Existing webhooks configured on your GitHub organization are not removed automatically. Remove obsolete webhooks manually from GitHub after upgrading.
• Shared GitHub organizations: If the same GitHub organization is used in multiple LinearB integrations, repositories discovered in other integrations will not be discovered in the upgraded GitHub App integration. Repositories remain associated with the integration that discovered them.

If the upgrade fails

If the upgrade fails, the integration displays Upgrade to GitHub App failed. LinearB also displays a dialog explaining the cause.

Common causes include:

• Selecting specific repositories instead of All repositories during GitHub App installation.
• Installing the LinearB GitHub App in a different GitHub organization from the one connected to the existing integration.

For detailed instructions, screenshots, and troubleshooting, see Upgrade an Existing GitHub Integration to the LinearB GitHub App .

Expand a Git integration to view all discovered and monitored repositories. From this view, you can search, filter, monitor, or unmonitor repositories without leaving the page.

The integration header displays the number of monitored repositories, the total number of discovered repositories, and the integration's current gitStream connection status.

1. Go to Settings → Company Settings → Git.
2. Under Integrations and Repositories, expand the Git integration you want to manage.
3. Use Search, the State filter, or the Visibility filter to locate repositories.
4. Select one or more repositories using the checkboxes.
5. Optionally, click Select all matching repositories to select every repository that matches the current filters.
6. Click Monitor to begin monitoring the selected repositories, or Unmonitor to stop monitoring them.

If a repository enters a Failing state, recover it directly from the Git integration page.

After recovery starts, the repository moves to Processing. If processing completes successfully, the repository returns to Monitored.

For detailed instructions, see Recover a Failing Repository.

If an integration is connected to gitStream, the integration header shows a connected to gitStream status.

• Click Disconnect gitStream to unlink it from the integration.
• You can reconnect later by reconfiguring gitStream from the integration settings.

1. Click Add Integration in the upper-right corner.
2. Select your Git provider, such as GitHub or GitLab.
3. Follow the on-screen steps to authenticate and grant access.

Admins can permanently remove a Git integration.

If the integration contains associated data, such as repositories, metrics, gitStream connections, or historical activity, deletion requires confirmation. If no data exists, deletion completes immediately.

1. Go to Settings → Company Settings → Git.
2. Select the integration to expand its details.
3. Click the vertical ellipsis (⋮) and choose Delete Integration.
4. Select a deletion option:
   • Remove everything — Permanently deletes the integration and all associated data.
   • Keep data — Removes the integration but preserves existing data in LinearB. Data remains visible, but no new updates are pulled.
5. Click Next, then Delete to confirm.