# Connect GitHub

> Link GitHub to InfraNest so your automations can react to what happens in your repositories — and act back on GitHub for you.

Source: https://infranest.io/docs/connect-github
Last updated: 2026-09-14

---

Connect your GitHub account or organisation to InfraNest so your automations can react to activity in your repositories and take action on GitHub for you.

## Overview
- Once connected, InfraNest can watch GitHub activity such as pushes, pull requests, issues, workflow runs, deployments, releases and checks.
- InfraNest can also act on GitHub as part of an automation — for example, open an issue, run a workflow, merge a pull request or update a deployment's status.
- Everything runs through the connection you set up here, and you can connect more than one account.

## Connect GitHub
The easiest and most secure way to connect is the automatic setup, which installs the InfraNest app on your GitHub account or organisation.

1. Go to **Integrations** and open **GitHub**.
2. Select **Connect**, then **Set up automatically**.
3. A GitHub window opens. Choose the account or organisation to install on, pick **All repositories** or just the ones you want InfraNest to see, and confirm.
4. You're returned to InfraNest and the connection appears under **Accounts**.

<!-- screenshot: connect-github -->

<!-- docs-screenshots:start:connect-github -->

![Connect GitHub](/media/0c98020d-6179-4116-a1c0-1f06e38abbf6)

<!-- docs-screenshots:end:connect-github -->

You can connect more than one account — for example your personal account and an organisation. Each shows up as its own connection.

> [!TIP]
Set up automatically is recommended wherever possible — it's more secure and there are no tokens for you to manage.

### Connect with a token instead
If you can't install an app (for example, on a self-hosted GitHub), choose **Use a token** instead and paste a personal access token with repository access.

## Choose what InfraNest can see
1. During **Set up automatically**, select the repositories you want InfraNest to access — either **All repositories** or specific ones.
2. To change this later, open the app on GitHub: go to your account or organisation **Settings → GitHub Apps → InfraNest**.
3. Adjust the selected repositories from there.

## Disconnect GitHub
1. Open **GitHub** in the Integrations hub.
2. Go to **Accounts**.
3. Select **Disconnect**.

> [!WARNING]
Disconnecting also uninstalls the app on GitHub, so InfraNest no longer has access. If the same installation is shared with another workspace, it's left in place there.

## Tips
- Your credentials are stored securely and never shown again.
- Team-based features (like requesting a review from a team) only work when you connect an organisation, not a personal account.

## Troubleshooting
- **Set up automatically isn't offered:** the connection only works once an administrator has set up GitHub for your InfraNest instance. Ask your administrator to finish the GitHub setup.

Once connected, head to Automate with GitHub to use GitHub triggers and actions in your automation rules.