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 receive workflow webhooks and register a self-hosted runner.

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. CRACI provisions a runner for the organization. When it reports configured, the connection is live.

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 and the runner stays connected.

Next

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