RelayRunner docs: Hosted providers Page: https://relayrunner.app/docs/runners/hosted Markdown: https://relayrunner.app/docs/runners/hosted.md All pages: https://relayrunner.app/docs/llms.txt Other pages (Markdown): - Changelog: https://relayrunner.app/docs/changelog.md - CLI changelog: https://relayrunner.app/docs/changelog/cli.md - CI traces in your observability tool: https://relayrunner.app/docs/changelog/opentelemetry-traces.md - Platform changelog: https://relayrunner.app/docs/changelog/platform.md - Retries, queueing and provider usage: https://relayrunner.app/docs/changelog/retries-queueing-and-provider-usage.md - Optimized checks: https://relayrunner.app/docs/concepts/optimized-checks.md - Principles: https://relayrunner.app/docs/concepts/principles.md - Routing: https://relayrunner.app/docs/concepts/routing.md - Runner order: https://relayrunner.app/docs/concepts/runner-order.md - Add a provider: https://relayrunner.app/docs/contribute/add-provider.md - Feedback: https://relayrunner.app/docs/contribute/feedback.md - Activity and history: https://relayrunner.app/docs/dashboard/activity.md - Performance: https://relayrunner.app/docs/dashboard/performance.md - Remove RelayRunner: https://relayrunner.app/docs/dashboard/remove.md - Signals: https://relayrunner.app/docs/dashboard/signals.md - Telemetry: https://relayrunner.app/docs/dashboard/telemetry.md - Usage and savings: https://relayrunner.app/docs/dashboard/usage.md - Workspaces and members: https://relayrunner.app/docs/dashboard/workspaces.md - Set up with an agent: https://relayrunner.app/docs/get-started/agents.md - How it works with GitHub Actions: https://relayrunner.app/docs/get-started/github-actions.md - Install the CLI: https://relayrunner.app/docs/get-started/install.md - Move your workflows over: https://relayrunner.app/docs/get-started/move-over.md - Route GitHub Actions jobs to any runner: https://relayrunner.app/docs/get-started/overview.md - Quickstart: https://relayrunner.app/docs/get-started/quickstart.md - Keep up with coding agents: https://relayrunner.app/docs/guides/agent-surge.md - Run CI on your laptop while you work: https://relayrunner.app/docs/guides/laptop-ci.md - macOS and iOS builds on your Mac: https://relayrunner.app/docs/guides/mac-builds.md - Spend controls: https://relayrunner.app/docs/guides/spend-controls.md - Share your team's machines: https://relayrunner.app/docs/guides/team-machines.md - RelayRunner API: https://relayrunner.app/docs/reference/api.md - CLI: https://relayrunner.app/docs/reference/cli.md - Errors: https://relayrunner.app/docs/reference/errors.md - FAQ: https://relayrunner.app/docs/reference/faq.md - GitHub App: https://relayrunner.app/docs/reference/github-app.md - Runner labels: https://relayrunner.app/docs/reference/labels.md - MCP server: https://relayrunner.app/docs/reference/mcp.md - Data and privacy: https://relayrunner.app/docs/reference/privacy.md - relay.yml inputs: https://relayrunner.app/docs/reference/relay-inputs.md - Repo config: https://relayrunner.app/docs/reference/repo-config.md - Security: https://relayrunner.app/docs/reference/security.md - Troubleshooting: https://relayrunner.app/docs/reference/troubleshooting.md - GitHub-hosted: https://relayrunner.app/docs/runners/github.md - Hosted providers: https://relayrunner.app/docs/runners/hosted.md (this page) - Providers: https://relayrunner.app/docs/runners/providers.md - Your machines: https://relayrunner.app/docs/runners/self-hosted.md --- # Hosted providers > Routing jobs to Blacksmith, Depot, Namespace, WarpBuild, Ubicloud and RunsOn. Hosted providers run GitHub Actions jobs on their own machines, under your account with them. Route jobs to any of these when your own machines are busy, or ahead of GitHub-hosted runners. ## Set it up 1. Install the provider's GitHub App on the organization and set up your account with them. A routed job only gets one of the provider's labels. The provider's App runs it and bills you. 2. Add the provider to your workspace's [runner order](/docs/concepts/runner-order) on the Router page. 3. Name one of its labels in the relay input of the same name: ```yaml relay-test: uses: relayrunner/actions/.github/workflows/relay.yml@v1 with: machine: self-hosted depot: depot-ubuntu-24.04 github: ubuntu-latest ``` Each job has its own relay, so each job picks its own size, such as `blacksmith-2vcpu-ubuntu-2404` for a lint job and `blacksmith-4vcpu-ubuntu-2404` for tests. `relayrunner init` keeps a job's existing provider label as its fallback, so a job already on a hosted provider stays there whenever no machine is free. ## Where it sits in the order A provider's step always takes a job that names one of its labels. There's no way to see a provider's capacity, so steps below it only run for jobs that don't name one. A common order is your machines, then a hosted provider, then GitHub-hosted. Unlike machines, hosted providers also run public repos' jobs. ## The providers | Provider | Relay input | | ---------- | ------------ | | Blacksmith | `blacksmith` | | Depot | `depot` | | Namespace | `namespace` | | WarpBuild | `warpbuild` | | Ubicloud | `ubicloud` | | RunsOn | `runs-on` | **Blacksmith**: Hosted runners for GitHub Actions. - Labels: `blacksmith-*` - Example: `runs-on: blacksmith-4vcpu-ubuntu-2404` - List price: $0.008/min (as of November 2026) - Links: [Docs](https://docs.blacksmith.sh), [Dashboard](https://app.blacksmith.sh) **Depot**: Hosted runners for GitHub Actions. - Labels: `depot-*` - Example: `runs-on: depot-ubuntu-24.04` - List price: $0.006/min (as of November 2026) - Links: [Docs](https://depot.dev/docs/github-actions/overview), [Dashboard](https://depot.dev/orgs) **Namespace**: Hosted runners for GitHub Actions, sized by runner profile. - Labels: `namespace-profile-*, nscloud-*` - Example: `runs-on: namespace-profile-default` - Links: [Docs](https://namespace.so/docs), [Dashboard](https://cloud.namespace.so) **WarpBuild**: Hosted runners for GitHub Actions. - Labels: `warp-*` - Example: `runs-on: warp-ubuntu-latest-x64-2x` - List price: $0.004/min (as of November 2026) - Links: [Docs](https://docs.warpbuild.com), [Dashboard](https://app.warpbuild.com) **Ubicloud**: Hosted runners for GitHub Actions. - Labels: `ubicloud, ubicloud-*` - Example: `runs-on: ubicloud-standard-2` - List price: $0.00125/min (as of November 2026) - Links: [Dashboard](https://console.ubicloud.com) **RunsOn**: Runners started in your own AWS account. - Labels: `runs-on=/runner=` - Example: `runs-on: runs-on=${{ github.run_id }}/runner=2cpu-linux-x64` - Links: [Docs](https://runs-on.com/docs/) RunsOn's label carries the run's id, so write it as an expression: `runs-on: runs-on=${{ github.run_id }}/runner=2cpu-linux-x64`. ## Good to know - Provider-only actions in a job, such as Blacksmith's cache actions, won't work on your machines or GitHub. `init` warns about Blacksmith's.