Share projects and runners with individual users, groups, or everyone in your organization. Resource admins can manage sharing for their resources. See Manage groups for group setup.
Share a project
Project admins can share their projects with other users and groups. When you create a project, you automatically become its admin.
- Open the project and click Share
- Click Add users or groups
- Select individual users or groups to add
- Choose a permission level for each:
| Role | Capabilities |
|---|
| User | View and use the project |
| Editor | Modify settings, manage secrets, configure environment classes |
| Admin | Full control including sharing and deletion |
Change permissions
- In the Share dialog, find the user or group
- Click the role dropdown
- Select a new permission level (takes effect immediately)
Remove access
- Click the role dropdown next to the user or group
- Select Remove access
Organization-wide access
To share with everyone in your organization:
- In General access, select your organization name
- All members get User access; you can still grant elevated permissions to specific users or groups
To restrict to specific users and groups only:
- In General access, select Only people with access
Share a runner
Runner admins can share their runners with other users and groups.
- Go to Settings → Runners
- Click ⋯ → Share runner
- Add users or groups and assign roles (same dialog as projects)
Runner roles:
| Role | Capabilities |
|---|
| User | Create environments on this runner |
| Admin | Configure runner settings, manage integrations |
Access dependencies
Users need access to both a project and at least one of its runners to create environments.
Share dialog warnings
The Share dialog displays warnings to prevent access issues:
When sharing a project:
“These users will not be able to use the project unless the underlying runner is also shared with them.”
When restricting runner access:
“Removing access to this runner may prevent these users from using projects that depend on it.”
