James Massardo - Geek of all things Technology

Setting up Shared Enterprise Actions



I recently had a customer that wanted to set up shared runners in their enterprise but the docs weren’t super clear so I wrote up these steps to make it easier.

The TLDR; is that the permissions are restrictive by default so you have to go to each layer and enable actions and the runner.

Documentation links:


  • Go to the Enterprise > Policies > Actions.
    • Ensure that Actions is enabled for all organizations (or at minimum, the specific organizations that hold the repos that need the runner)

      actions policy

  • Create (or update) a runner group and select all organizations (or the specific organizations) runner group
  • Create a new runner and add it to the runner group
  • Now go to each org that needs to use the runner and do the following:
    • Verify Actions is enabled at the org level (org > settings > actions > general actions permissions
  • In the Runner Groups, select the runner group under the “Shared by the Enterprise” header enterprise runners
  • Specify either all repos, or select the desired repos for access: repository access


Obviously, this is a manual process and won’t work if you have a large number of organizations. Since enterprises have so many different variations, I’m only including the base API calls.

# create runner group
curl \
  -X POST \
  -H "Accept: application/vnd.github.v3+json" \
  https://api.github.com/enterprises/ENTERPRISE/actions/runner-groups \
  -d '{"name":"name"}'

# Get a registration token
curl \
  -X POST \
  -H "Accept: application/vnd.github.v3+json" \

# Add a runner to the group 
curl \
  -X PUT \
  -H "Accept: application/vnd.github.v3+json" \

# Ensure that all the repos in an org have the runner
curl \
  -X PUT \
  -H "Accept: application/vnd.github.v3+json" \
  https://api.github.com/orgs/ORG/actions/runner-groups/42/repositories \
  -d '{"selected_repository_ids":[42]}'


If you have any questions or feedback, please feel free to contact me: @jamesmassardo