---
title: "GitHub integration for Grafana IRM | Grafana Cloud documentation"
description: "Configure GitHub integration for Grafana IRM to link incidents with repositories and issues"
---

# GitHub integration for Grafana IRM

The GitHub integration for Grafana IRM connects your incident response workflow with your GitHub repositories, enhancing collaboration during incidents. This integration provides increased visibility and context by syncing critical details between incidents and GitHub issues.

## Key features

- Link incidents to specific GitHub repositories
- Convert IRM tasks to GitHub issues and vice versa
- Access GitHub issues directly from the incident interface
- Track code-related changes that occur during incident response

For more information about managing tasks using the GitHub integration, refer to [Add and manage tasks](/docs/grafana-cloud/alerting-and-irm/irm/manage-incidents/collaborate/manage-tasks)

## Before you begin

To use the GitHub integration, you need:

- Admin permissions in Grafana IRM
- GitHub admin permissions to enable the Grafana IRM app
- Access to the GitHub repositories you want to connect

> Note
> 
> If you’re not a GitHub admin, request approval from your organization admin to enable the Grafana IRM app.

## Configure the GitHub integration

1. Navigate to **IRM** > **Integrations** in the Grafana menu
2. Select the **Incident** tab
3. Click the **GitHub** tile
4. Click **Install Integration**
5. Follow the on-screen instructions to sign in to GitHub
6. Authorize the Grafana IRM app when prompted

After the GitHub integration is installed, you need to select which repositories to connect.

## Configure repository access

To specify which GitHub repositories to connect:

1. From the GitHub integration settings page, click **Manage Integration Permissions**
2. When redirected to GitHub, click **Configure**
3. Select the repositories you want to connect to Grafana IRM
   
   - You can choose specific repositories or grant access to all repositories
4. Save your changes and return to Grafana IRM

## Using the integration

Once configured, you can use the GitHub integration to:

### Link tasks to GitHub issues

1. Create a task in your incident
2. Click the task options menu (three dots)
3. Select **Link to GitHub issue**
4. Choose an existing issue or create a new one

### View linked GitHub issues

Linked GitHub issues appear in the incident details page, providing context about code-related activities during the incident.