Skip to main content

About runner groups

Learn about what a runner group is, and how to use them to control access to runners at the organization and/or enterprise levels

About runner groups

To control access to runners at the organization and/or enterprise levels, enterprise and organization owners can use runner groups. Runner groups are used to collect sets of runners and create a security boundary around them.

When you grant access to a runner group, you can see the runner group listed in the organization's runner settings. Optionally, you can assign additional granular repository and workflow access policies to the runner group.

When new runners are created, they are automatically assigned to the default group unless otherwise specified. Runners can only be in one group at a time. You can move runners from one runner group to another.

Next steps

For information on how to route jobs to runners in a specific group, see Choosing the runner for a job.