---
title: "Connect your GitHub organization"
description: "Install the CRACI GitHub App so your workflows can run on CRACI runners"
source: "https://docs.craci.com/guides/github-connection/"
---

Before any workflow can use `runs-on: craci`, CRACI must be connected to your GitHub organization. The connection is a **GitHub App** installed on your org; it lets CRACI run workflows from the repositories you select.

## Connect

1. In CRACI, go to **Settings → Builds** and start the **Install GitHub** flow. CRACI walks you through creating its GitHub App and installing it on your organization.
2. During installation, grant the App access to the repositories whose workflows should run on CRACI (all repositories, or a selected set).
3. When the connection reports **configured**, your workflows can run on CRACI.

The GitHub App is installed once per organization. Re-running the flow is a no-op once the App is installed.

## Updating permissions

To change which repositories CRACI can build, update the App's installation on GitHub rather than re-running the flow. From your organization's **Settings → GitHub Apps → CRACI → Configure**, adjust the repository access (all repositories, or a selected set). The change takes effect immediately.

## Next

With the connection live, point a job at CRACI and run a build; see [Run workflows on CRACI runners](/guides/runner-workflows/).