> ## Documentation Index
> Fetch the complete documentation index at: https://docs.incredibuild.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub Actions Runners

> Accelerate your GitHub Actions workflow on Incredibuild managed runners with zero-config caching - change one line in your YAML.

<Note>GitHub Actions Runners are in **Beta**. They run on **Ubuntu x64** with out-of-the-box
acceleration for **C++** and **Rust**.</Note>

## 1. Connect GitHub

1. Log in to [app.incredibuild.com](https://app.incredibuild.com/).
2. Click **Accelerate GitHub Actions**.
3. Click **Connect to GitHub**, then install the Incredibuild app on your account:

<Tabs>
  <Tab title="Personal">
    Install on your personal GitHub account. **Access is limited to your personal repos.**
  </Tab>

  <Tab title="Organization">
    1. Install on your organization's GitHub account. **Requires admin permissions.**
    2. Connect your personal account.
  </Tab>
</Tabs>

## 2. Select a repository and create a runner

Select the GitHub repository to accelerate, then click **Create hosted build runner**.

## 3. Update your workflow

To configure your GitHub Actions to use Incredibuild runners, change the runner label in your
workflow YAML file under `.github/workflows/`. For example:

```diff theme={null}
  jobs:
    build:
-     runs-on: ubuntu-24.04
+     runs-on: incredibuild-runner
```

Commit and push. The next time the workflow triggers, it runs on Incredibuild with caching enabled.

```bash theme={null}
git add .github/workflows/ && git commit -m 'Use Incredibuild runners' && git push
```

## What's next

<CardGroup cols={2}>
  <Card title="Builds" icon="list-check" href="/console/builds">
    See each run and drill into its tasks.
  </Card>

  <Card title="Analytics" icon="chart-line" href="/console/analytics">
    Track build times and cache hit rate over time.
  </Card>
</CardGroup>