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
- In app.kosa8.com, check you have a payment method on file (Usage → Choose how to pay). Runners use sized sandboxes, which need one.
- As an admin, open the GitHub link from
GET /v1/integrations/github(theinstall_urlfield). 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. - Change
runs-onin 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
| Label | vCPU | RAM | About, per hour |
|---|---|---|---|
kosa8-2x4 (default) | 2 | 4 GiB | $0.158 |
kosa8-4x8 | 4 | 8 GiB | $0.315 |
kosa8-8x16 | 8 | 16 GiB | $0.630 |
kosa8-16x32 | 16 | 32 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
- GitHub sends kosa8 a
workflow_jobevent when a job with thekosa8label is queued. kosa8 creates a sandbox and registers a just-in-time runner for the repository. The runner takes one job and exits. - When the job completes, the sandbox is deleted. A runner that gets no job within 15 minutes is deleted and unregistered. Every runner sandbox is also deleted after 6 hours at most.
- The runner's registration token reaches the sandbox as an environment value. The audit log records the command, never that value.
- To stop, uninstall the app on GitHub, or call
DELETE /v1/integrations/github/{installation_id}.