RelayRunner docs: Share your team's machines Page: https://relayrunner.app/docs/guides/team-machines Markdown: https://relayrunner.app/docs/guides/team-machines.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 (this page) - 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 - Providers: https://relayrunner.app/docs/runners/providers.md - Your machines: https://relayrunner.app/docs/runners/self-hosted.md --- # Share your team's machines > Pool the team's spare computers so anyone's jobs can use them. Most teams have computers sitting idle: a Mac mini in the office, a workstation that's off-hours half the day, last year's laptop. Pool them, and anyone's jobs can run on whichever one is free. ## 1. Bring the team in The workspace is your org's GitHub App install, and its members come from GitHub. Anyone who can see the install on GitHub joins when they sign in to RelayRunner, so there's nobody to invite. Members can connect machines, pause them and see activity. Owners and admins also manage the runner order and roles under **Settings → Members**. ## 2. Connect the shared machines On each shared computer: ```sh npx relayrunner connect --share anyone ``` **Anyone** lets the machine take any job in the workspace, including teammates' and bots'. A machine you keep for yourself stays on **only me**. ## 3. What "anyone" covers A machine shared with anyone only takes jobs from repos its owner can open on GitHub. Being in the same workspace isn't enough. That way, connecting a machine never gives it code or secrets its owner couldn't already see. So the person who connects a shared machine should have access to every repo you want it to serve. A team or service account works well for this. ## 4. How jobs are spread Each job goes to an idle machine. The machines of the person who started the job come first, then whichever one was picked least recently, so work spreads across the pool. ## Personal laptops in the pool A teammate can connect their own laptop too, on **only me**. Their pushes use it first, and everything else uses the shared machines. If they want to help the team while they're away, they can switch it to **anyone** and back. ## When someone leaves Remove them from the org on GitHub. They leave the workspace, and their machines stop taking its jobs.