Connect your GitHub organization

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.

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.

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.

With the connection live, point a job at CRACI and run a build; see Run workflows on CRACI runners.