Getting started

Quickstart

Faster, Cheaper, Greener GitHub Actions in three simple steps.

1. Sign in & connect the CarbonRunner GitHub app

Open the CarbonRunner dashboard and grant the permissions we need to execute your GitHub Action jobs on our carbon-aware infrastructure.

Questions about org access and repo scope?

Learn how GitHub's repository access works to connect your org to CarbonRunner.

2. Update your `runs-on` line

Update your workflow’s runs-on line to use CarbonRunner. We’ll pick up the PR checks automatically — that run will be the first you see in the dashboard.

1
2jobs:
3  deploy: 
4-   runs-on: ubuntu-latest
5+   runs-on: carbonrunner-2vcpu-ubuntu-latest
6

3. Action! Run your Actions & see the savings.

Trigger a run (or wait for the next one). We auto-route to the cleanest, fastest region.