Celesto integration
Route jobs between Celesto, your machines and GitHub.
Celesto runs GitHub Actions jobs on its own machines, under your Celesto account. Jobs go to your machines first and to Celesto when they're busy. You change the order from the dashboard, not your workflows.
With routing
Celesto on its own, or in your runner order
Celesto on its own
- Each workflow names a Celesto label, so every job runs on Celesto.
- Your own machines sit idle while Celesto bills you.
- Trying another host means editing every workflow again.
- Each host shows its own job times in its own dashboard.
In your runner order
- Jobs run on your machines first, and on Celesto when your machines are busy.
- GitHub-hosted runners stay as the fallback after Celesto.
- Move Celesto up, down or out from the dashboard. No workflow edits.
- The Performance page compares Celesto's job times with your machines and GitHub-hosted runners.
Setup
How to set up Celesto
-
Set up your Celesto account
Sign up for Celesto and install the celesto-ci GitHub App, then add credit: the trial runs celesto-micro only.
-
Add Celesto to your runner order
On the Router page, put Celesto where you want it. A common order is your machines, then Celesto, then GitHub-hosted.
-
Add relays to your jobs
Run
npx relayrunner initin your repo. It adds a relay to each job you pick and keeps the label the job uses today as its fallback.
jobs:
relay-test:
uses: relayrunner/actions/.github/workflows/relay.yml@v1
with:
machine: self-hosted
celesto: celesto-standard
github: ubuntu-latest
test:
needs: relay-test
runs-on: ${{ needs.relay-test.outputs.runner }}
The relay
Name a Celesto label in the relay.
The relay answers in about a second and uses no minutes. It returns the label of the first runner in your order that can take the job, and the job runs there.
Read how routing works →Details
Celesto at a glance
- What it is
- Linux runners for GitHub Actions on Celesto's sandboxes.
- Labels
celesto, celesto-*- Example
runs-on: celesto-standard- Relay input
celesto- Links
- Celesto docs Celesto dashboard
Plans
Credit is prepaid from $2.01. The trial credit lasts 30 days.
| Plan | Monthly | Included |
|---|---|---|
| Pay as you go | No fee | $5 trial, Micro only |
From Celesto's pricing page, checked Nov 17, 2026.
List prices
| celesto-micro | $0.00025/min |
|---|---|
| celesto-small | $0.00033/min |
| celesto-standard | $0.0005/min |
| celesto-memory | $0.00067/min |
| celesto-large | $0.00133/min |
| celesto-xl | $0.00267/min |
As of November 2026, from Celesto's price page. Celesto bills you directly, so your plan and credits apply.
Common questions
How is this different from using Celesto directly?
Used directly, every job that names a Celesto label runs on Celesto. In a runner order, jobs go to your own machines first and to Celesto only when they're busy, and you can move Celesto up, down or out from the dashboard without editing workflows.
Do I have to change my workflows to use Celesto?
Once. Run npx relayrunner init in your repo and it adds a relay to each job you pick. After that, you move Celesto up or down in the dashboard.
Which jobs go to Celesto?
Jobs whose relay names a Celesto label, when nothing above Celesto in your runner order is free.
Who bills me for Celesto?
Celesto does. Jobs run under your own Celesto account, so your plan, credits and discounts still apply.
Do public repos run on Celesto?
Yes. Your own machines skip public repos' jobs, but hosted providers like Celesto run them.
Add Celesto to your runner order.
Add relays once. After that, change the order in the dashboard.
-
1. In your repo, add relays to the jobs you want to route
npx relayrunner init -
2. Optionally, turn this computer into a runner
npx relayrunner connect