Organizations
Share runners with your team, assign roles, invite members and switch between organizations.
Runners, schedules, monitoring data and the plan belong to an organization. Everyone in an organization sees the same runners, and the organization’s plan applies to all of them.
Your default organization
When you register, Manage Runners creates an organization for you and makes you its owner. It is your default organization: the dashboard selects it after you sign in, and the CLI and API use it when no other organization is selected.
Switch and create organizations
The organization menu at the top of the dashboard lists your organizations with your role in each. Select one to switch; the dashboard then shows that organization’s runners.
To create one, select Create organization in the menu and enter a name of up to 100 characters. You become its owner. A new organization starts without a plan, so its owner has to choose one under Billing before its runners can be used.
Roles
| Role | Can |
|---|---|
| Owner | Everything, including billing, members and invitations. |
| Editor | Create, change, pause and delete runners and schedules. |
| Viewer | See runners, their status and metrics. No changes. |
Each organization has exactly one owner: the person who created it. The owner role cannot be given to someone else, and the owner cannot leave the organization.
Editors can also see the SSH keys available to a runner’s Hetzner token, because they edit runners. Viewers see the dashboard without any runner actions.
Organization settings
Select Organization in the sidebar.
- Name: the owner can rename the organization.
- Your role and Plan show your access and the organization’s plan.
- Members: the owner can change members between Editor and Viewer, and remove them. A removed member loses access immediately.
Invite members
Only the owner can invite people.
- Under Invitations, select Invite member.
- Enter the email address and choose Editor or Viewer.
- Select Send invitation.
The person receives an email with a link. They sign in, or register with that email address, and select Accept invitation. The link works once and expires after a week. An invitation can only be accepted by an account with the invited email address.
Pending invitations stay in the list until they are accepted. The owner can Resend an invitation, which sends a new link and stops the old one from working, or Revoke it.
Leave an organization
Members other than the owner can leave under Leave organization. They lose access immediately; the owner has to invite them again for them to return.
Organizations in the CLI and API
The CLI and personal access tokens work with your default organization unless you select another one. See Profiles and organizations. A personal access token can never do more than your role in the organization allows. Creating organizations, renaming them, and managing members and invitations are only available in the dashboard.