Guides

Run GitHub Actions on land

Install the land app, change runs-on to land, and your jobs run on land's machines, billed per minute.

Set up in three steps

  1. Install the land app on your GitHub organization and pick the repositories it may serve.
  2. GitHub sends you back to the land dashboard, which links the installation to your account. Only the person who installed the app can link it.
  3. Change one line in each job you want on land, and push:
# .github/workflows/ci.yml
jobs:
  test:
-   runs-on: ubuntu-latest
+   runs-on: land
    steps:
      - uses: actions/checkout@v4
      - run: npm test

The job runs on a fresh land microVM with GitHub's own runner inside, so your steps, actions and logs stay exactly where they are. Jobs that still say ubuntu-latest keep running on GitHub.

Let your agent move the jobs

Paste this into Claude Code or Codex in your repository. It looks first, changes nothing until you say go, and opens one pull request.

Move this repository's GitHub Actions jobs to land's runners.

1. List every job in .github/workflows/*.yml whose runs-on is ubuntu-latest (or ubuntu-22.04 / ubuntu-24.04).
   Leave alone any job on Windows, macOS, ARM, a matrix of operating systems, or self-hosted labels.
2. Show me the list and change nothing until I say go.
3. On go, change only those runs-on lines to: runs-on: land
   Commit on a new branch (land-runners) and open one pull request with gh. Never merge it.
4. Watch the pull request's checks. For each moved job, read its runner name from the GitHub API
   (gh api repos/{owner}/{repo}/actions/runs/{run}/jobs); it must start with "land-".
5. If a job stays queued for more than 3 minutes, stop and tell me: the land app may not be installed on
   this repository, or the account may need a card on useland.dev/dashboard.

What it costs

A job is billed from GitHub's own start and end times, on a 4 vCPU machine at $0.0016 a minute, against the same 500 free minutes a month as your land checks. When an account is past its free minutes with no card, land does not take new jobs: they wait in GitHub's queue until you add a card on the dashboard.

What runs and what doesn't

Beta. A job runs on Debian 13 with the tools CI jobs usually need (git, curl, jq, build-essential, cmake, Python 3 with pip and venv, zip, rsync, sudo). It is not GitHub's ubuntu-latest image: install anything else a job needs in its steps, or with actions such as setup-node.

  • Linux x64 jobs, one size (4 vCPU). The label is land.
  • No Windows, macOS or ARM runners, and no Docker inside a job.
  • A job asking for land together with another label ([land, gpu]) is not taken.

The free GitHub Action is the other way to use land on GitHub: it runs on GitHub's own runners and only skips tests. These runners are land's machines, billed per minute.