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

# GitHub Actions quickstart

> Connect a GitHub repository to LayerRail-managed runners, install the GitHub App, and run your first workflow on dedicated runner hardware.

LayerRail GitHub runners let workflows run on project-managed compute instead of shared hosted runners.

## Install the GitHub App

<Steps>
  <Step title="Open GitHub runners">
    In the LayerRail console, open your project and choose **GitHub Runners**.
  </Step>

  <Step title="Connect a GitHub account">
    Choose **Connect new account** and install the LayerRail GitHub App for the organization or repositories you want to use.
  </Step>

  <Step title="Return to LayerRail">
    After installation, GitHub redirects back to the LayerRail console.
  </Step>

  <Step title="Choose repositories">
    Choose which repositories can use LayerRail runners.
  </Step>
</Steps>

## Use a runner label

Add the LayerRail runner label to a workflow:

```yaml theme={null}
name: CI

on:
  push:

jobs:
  test:
    runs-on: layerrail
    steps:
      - uses: actions/checkout@v4
      - run: echo "Running on LayerRail"
```

<Tip>
  Use project-level runner access when you want billing, audit logs, and compute isolation to follow the LayerRail project.
</Tip>