Skip to content

FAQ

Common questions about RelayRunner.

Yes. It’s open source, and the core routing will stay that way. We plan to add a paid tier later for advanced management, aimed at larger teams. Nothing you set up now will need to change.

No. Your machines are yours, and hosted providers bill you directly under your own accounts. A routed job only gets a label.

No. A relay job finishes in about a second, without a runner. Optimized checks don’t use minutes either.

Does it work with my existing GitHub Actions workflows?

Section titled “Does it work with my existing GitHub Actions workflows?”

Yes. Each routed job gets a relay job in front of it and a runs-on that reads its answer. Steps, check names and logs stay the same. See GitHub Actions.

Jobs go to the next step in your runner order, usually GitHub-hosted, with nothing to change. A job that was running when it closed stops. Re-run it and it routes again (see Re-running a job), or turn on automatic retries to have the Router re-run it for you.

Yes, relayrunner connect is the on/off switch. While it runs, the machine takes jobs.

On a Mac with Apple silicon, no. Each job runs in its own Linux VM that sees none of your files. On Linux and Intel Macs a job runs as you, like on any self-hosted runner, so route jobs only from repos you trust. See Security.

Public repos can use relays to choose between hosted providers, and optimized checks. Their jobs never run on your machines.

Not yet. Machines can be macOS or Linux, on x64 or ARM64.

Can I use it with GitHub Enterprise Server?

Section titled “Can I use it with GitHub Enterprise Server?”

Not yet. It works with organizations and personal accounts on github.com.

Can a job run on several machines at once, like a matrix?

Section titled “Can a job run on several machines at once, like a matrix?”

Not through one relay. Each relay routes one job, so matrix jobs aren’t routed. Give separate jobs their own relays.

Can my teammates’ jobs run on my laptop?

Section titled “Can my teammates’ jobs run on my laptop?”

Only if you share it with anyone. A new machine only runs jobs you started.

No. Jobs on your machines use GitHub’s own runner, which talks to GitHub directly. See Data and privacy.

The code is on GitHub. The hosted service at app.relayrunner.app is the supported way to use it today.

It routes to your own machines, existing self-hosted runners, GitHub-hosted runners, and hosted providers such as Blacksmith, Depot and Namespace. See Providers.