kosa8 docs

Guides / kosa8 Cloud / GitHub Actions runners

GitHub Actions runners on kosa8 Cloud

Run your GitHub Actions jobs on kosa8 Cloud. Each job gets a fresh runner in its own sealed microVM, which is deleted when the job ends. You pick the size per job, from 2 to 16 vCPUs, and pay only for the seconds it runs.

Set it up once

  1. In app.kosa8.com, check you have a payment method on file (Usage → Choose how to pay). Runners use sized sandboxes, which need one.
  2. As an admin, open the GitHub link from GET /v1/integrations/github (the install_url field). Choose the account and repositories, and approve the request to confirm who you are. GitHub then sends you back to kosa8, which links the installation to your organization.
  3. Change runs-on in the workflows that should run on kosa8:
jobs:
  test:
    runs-on: [self-hosted, kosa8, kosa8-4x8]
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm test

Sizes

LabelvCPURAMAbout, per hour
kosa8-2x4 (default)24 GiB$0.158
kosa8-4x848 GiB$0.315
kosa8-8x16816 GiB$0.630
kosa8-16x321632 GiB$1.261

Rates are the usual $0.048 per vCPU-hour and $0.0154 per GiB-hour, billed per second from when the runner's sandbox is up until it is deleted, before the region multiplier. Booting takes from seconds up to a few minutes the first time a host pulls the runner image. Each host runs at most 24 vCPUs of these at once. Past that, and past your organization's limit of running sandboxes, jobs wait in GitHub's queue, and kosa8 retries each minute for an hour.

What is in the runner

The runner image is the GitHub Actions runner (v2.338.2) on kosa8's universal image. It has git and git-lfs, compilers, Python, Node.js and the other tools listed on the universal image page. Commands run as root. The sandbox is persistent, so services a step starts in the background keep running for the steps after it.

How it works