> ## Documentation Index
> Fetch the complete documentation index at: https://docs-sre.lightrun.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub Authentication

> Connect GitHub repositories to AI SRE

Connect your GitHub repositories to enable AI SRE to access your codebase, track changes, and correlate deployments with incidents.

## Overview

When connected, AI SRE:

* **Accesses code** — Reviews code structure, dependencies, and recent changes
* **Tracks deployments** — Monitors commits, pull requests, and deployment timelines
* **Correlates changes** — Links code changes with incidents to identify root causes
* **Maps dependencies** — Understands service relationships and ownership

## Setup during onboarding

GitHub connection happens during onboarding:

1. **Sign in** — Log in to AI SRE
2. **Company setup** — If you're the first user, create your company account
3. **Connect GitHub** — The wizard prompts you to connect GitHub
4. **Authorize** — You'll be redirected to GitHub to authorize the AI SRE GitHub App
5. **Select organization** — Choose the GitHub organization to connect
6. **Select repositories** — Choose which repositories AI SRE can access
7. **Complete** — Return to AI SRE to finish setup

## Repository selection

Connect repositories that contain services you investigate during incidents. AI SRE uses these repositories to review code changes, track deployments, and correlate with incidents.

**Best practices:**

* Start with 1–2 critical production repositories
* Include repositories with active development and frequent deployments
* Add additional repositories as your needs grow
* Regularly review and update your connected repositories

## Troubleshooting

### Insufficient permissions

If you see an "Insufficient Permissions" error, you don't have the required permissions to install the GitHub App at the organization level.

**Solution:** Ask your GitHub organization administrator to install the app, or install it at the repository level if you have repository admin access.

### Repository not found

If a repository isn't accessible, verify:

* You have access to the repository
* The repository visibility settings allow your access level
* The repository exists and hasn't been deleted or renamed

### Authentication failed

If the OAuth flow fails:

* Try the authentication process again
* Clear your browser cache and cookies
* Ensure pop-up blockers aren't preventing the GitHub authorization page

## Managing connections

### View connected repositories

Navigate to **Connectors** → **GitHub** in the AI SRE interface to see which repositories are connected and their connection status.

### Update repository selection

To add or remove repositories:

1. Go to your GitHub App settings
2. Modify repository access permissions
3. Changes automatically sync to AI SRE

### Disconnect GitHub

To disconnect GitHub:

1. Go to **Connectors** → **GitHub** in AI SRE
2. Click **Disconnect**
3. Confirm the disconnection

**Note:** Disconnecting removes AI SRE's access to repository data. You'll need to reconnect to use GitHub-related features.

## Next steps

<CardGroup cols={2}>
  <Card title="Quick Tour" icon="compass" href="/getting-started/quick-tour" />
</CardGroup>