Access is by invitation. Ask your Darkbloom contact about onboarding,
approved repositories and the hosts your jobs need to reach.
Who it is for
Use Darkbloom runners for CI checks that fit the routing rules: builds and tests on Linux and macOS, including Xcode and Metal work. Release, publishing and deployment jobs stay on your own runners. The route workflow asks Darkbloom whether it can take each lane of a run. If Darkbloom is off, unreachable, slow or says no, every lane keeps its fallback label and the run continues on your usual runners. A lane that Darkbloom accepts runs on a Darkbloom runner; if Darkbloom then cannot start its jobs, they wait on GitHub until you cancel and re-run it (see troubleshooting).Public repositories only
Darkbloom runs public repositories only. Private repositories show Private in the console and cannot be requested. Your jobs run on Macs that other people own. Darkbloom checks at every job that the repository is public and refuses private ones, so nothing a Mac sees is secret: the code is public, the job’s token is read-only, and routed jobs cannot hold secrets. See security for what the Mac’s owner can see and what Darkbloom keeps.Linux and macOS
Your approval sets each profile’s size, and so its runner class. See
runner images for the operating systems and tools each
class provides.
How a run is routed
- A
routejob at the start of the run asks Darkbloom which lanes it can take and reserves capacity for their jobs. - Each routed job takes its
runs-onfrom the route job’s answer: Darkbloom’s runner labels, or the lane’s fallback label. - A lane that was routed can only run on a Darkbloom runner. The optional watchdog workflow rescues a run whose routed jobs never get one.
Billing
Jobs are paid from your Darkbloom balance, the same balance Darkbloom inference uses. A job holds funds when it starts and settles to its billable time at the rate in effect when it started; the rest of the hold is released. Rates are per minute of each runner class and billed per second, as of November 2026; the CI pricing page lists them, and the live rates are in the sandbox console under Billing → Rates. A monthly cap and a concurrency limit apply per installation. Lanes that would not fit the monthly cap fall back to your runners. See limits and billing.Next steps
Quickstart
Sign in, install the GitHub App, route a workflow, and watch the job run.
Route workflows
Copy the route workflow, declare lanes, and keep jobs on their fallback.
Runner images
What is installed on Linux and macOS runners, and how to add tools.
Limits and billing
Concurrency, spend caps, holds, and what a finished job costs.

