> ## 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.

# GitLab CI Runners

> Accelerate your GitLab CI/CD pipelines on Incredibuild managed runners with zero-config caching - add one tag to your job.

<Note>GitLab CI Runners are in **Beta**. Beta scope - supports **Linux runners on Ubuntu
x64**.</Note>

## 1. Connect GitLab

1. Log in to [app.incredibuild.com](https://app.incredibuild.com/).
2. Click **CI/CD acceleration**, then select the **GitLab** tab.
3. Click **Install** to connect your GitLab account.

## 2. Select a project and create a runner

Select the GitLab project to accelerate, then click **Create runner**.

<Note>Only projects where you have at least the **Maintainer** role are available to select.</Note>

## 3. Update your pipeline

To route a job to your Incredibuild runner, add `tags: [incredibuild]` to it in
`.gitlab-ci.yml`. Everything else stays the same.

```diff theme={null}
  build:
    image: gcc:14
+   tags: [incredibuild]
    script:
      - cmake --build build --parallel
```

Commit and push. The next time the job runs, it's picked up by your Incredibuild runner with
caching enabled.

```bash theme={null}
git add .gitlab-ci.yml && 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>