Manage runners
Accounts and teams
Connect personal and organization accounts, share machines, and manage team access.
Switch accounts
You can connect your personal GitHub account and organizations to Mirage. Use the account menu in the dashboard to switch between them. Runs, repository settings, available runners, and billing estimates reflect the selected account.
A GitHub App installation gives Mirage access to an account’s selected repositories. You may see the word “installation” in settings or CLI output; choose the one for the repository you are configuring. Switching the dashboard account does not change which accounts a machine serves.
Share a machine
Open a machine you control in Machines. Under Available to, choose which connected GitHub accounts may schedule jobs on it. A shared machine must also have an active capacity grant for that account; organization administrators can review grants in Runners.
Machines is where you manage your hosts. Runners shows capacity the selected account can use, including machines shared by other people. Offering capacity does not transfer ownership of your machine.
A machine shares its slots across accounts. Giving two organizations access to a one-slot Mac still permits only one job at a time. Each account must also enable repository routing and have GitHub App access to the repository.
Team permissions
Organization owners and administrators can open People in Runners to invite a teammate by their exact GitHub username and assign a role. Invitations expire after seven days and are tied to that GitHub identity. Personal accounts do not have team memberships.
| Role | What they can do |
|---|---|
| Owner | Manage the account, members, repositories, providers, and capacity, including account ownership and deletion. |
| Admin | Manage members, repositories, runs, billing, providers, and capacity. |
| Contributor | View the account and its available runners, and offer machine capacity. |
Mirage roles do not grant GitHub repository permissions. If you cannot change a setting, ask a Mirage owner or admin; if GitHub rejects an App installation or a workflow edit, check your GitHub permissions too.
Stop sharing capacity
Remove an account from a machine’s Available to list, or manage its grant in Runners. To stop a Mac from accepting all new jobs temporarily, pause it. Before removing an account’s last machine permanently, make sure its workflows have hosted fallback or restore GitHub-hosted labels.