RelayRunner docs: Workspaces and members Page: https://relayrunner.app/docs/dashboard/workspaces Markdown: https://relayrunner.app/docs/dashboard/workspaces.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 (this page) - 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 - Providers: https://relayrunner.app/docs/runners/providers.md - Your machines: https://relayrunner.app/docs/runners/self-hosted.md --- # Workspaces and members > One workspace per GitHub install, its roles, and where members come from. A workspace is one install of the RelayRunner GitHub App. Install it on an organization or personal account and that account becomes a workspace, named after it, with its own runner order, activity and members. Your machines aren't tied to one: each takes your jobs in every workspace you're in. ## GitHub installation Installing the App makes the workspace, and the person who installed it is its owner. **Settings → GitHub** links to the install on GitHub, where you choose which repos RelayRunner sees. Uninstalling the App deletes the workspace. If the App was installed by someone who isn't an org owner, GitHub sends the owners a request. The workspace appears once an owner accepts it. Organizations and personal accounts both work. A few things only work for organizations, such as runner groups and reading your Actions budget. ## Roles | | Member | Admin | Owner | | ------------------------------------------- | ------ | ----- | ----- | | Connect, pause and share their own machines | ✓ | ✓ | ✓ | | Pause any machine | ✓ | ✓ | ✓ | | See activity, runs and usage | ✓ | ✓ | ✓ | | Remove any machine | | ✓ | ✓ | | Change the runner order | | ✓ | ✓ | | Add existing runners | | ✓ | ✓ | | Make someone an admin | | ✓ | ✓ | | Make someone an owner | | | ✓ | ## Members Membership comes from GitHub. Anyone who can see the workspace's installation on GitHub joins as a member when they sign in to RelayRunner, and leaves when GitHub stops showing it to them, for example when they leave the org. There are no invites: to add someone, give them access to the org on GitHub. Owners and admins change roles under **Settings → Members**. Leaving a workspace doesn't remove your machines. They stop taking that workspace's jobs and keep working in your other workspaces. ## More than one workspace Each install is its own workspace, so installing the App on another org adds one. Use **Add an organization** in the workspace menu at the top of the sidebar, and switch between workspaces there too. A machine you connect is in all of them. ## Emails A few service emails come from `noreply@send.relayrunner.app`. There's no marketing email. | Email | Sent to | When | | --------------------------- | -------------------------- | ----------------------------------------------------------------------------------------------------------------- | | Welcome | You | You sign up. | | New machine connected | The person who approved it | You connect a new machine. | | Machine signed in elsewhere | The person who approved it | A machine's token signs in from another network while the machine is online. Remove the machine if it wasn't you. | Everything else, such as routing decisions and failed relays, is on the **Activity** page. A failed relay also fails its job on GitHub, so it shows up wherever you already get CI failures.