Skip to main content

Getting started with GitHub Actions for GitHub Enterprise Cloud

Configure GitHub Actions on GitHub Enterprise Cloud.

GitHub Actions is enabled for your enterprise by default. To get started using GitHub Actions within your enterprise, you can manage the policies that control how enterprise members use GitHub Actions and optionally add self-hosted runners to run workflows.

Managing policies for GitHub Actions

You can use policies to control how enterprise members use GitHub Actions. For example, you can restrict which actions are allowed and configure artifact and log retention. For more information, see Enforcing policies for GitHub Actions in your enterprise.

Adding runners

To run GitHub Actions workflows, you need to use runners. A runner is a server that runs your workflows when they're triggered. If you use GitHub-hosted runners, you will be billed based on consumption after exhausting the minutes included in your plan, whereas self-hosted runners are free. For more information, see GitHub Actions billing.

For more information, see Self-hosted runners.

If you choose self-hosted runners, you can add runners at the enterprise, organization, or repository levels. For more information, see Adding self-hosted runners.

Provisioning fine-grained permissions for GitHub Actions

Organization owners and users with the "Manage custom organization roles" permission can provision fine-grained permissions for users and teams in your organization. Provisioning fine-grained permissions for GitHub Actions allows you to practice the principle of least privilege to secure settings in your GitHub Actions CI/CD pipeline.

For GitHub Actions, you can enable any of the following permissions for individuals or teams in your organization.

  • Manage organization Actions policies: Access to manage all settings on the "Actions General" settings page, except for self-hosted runners settings.
  • Manage organization runners and runner groups: Access to create and manage GitHub-hosted runners, self-hosted runners, and runner groups, and control where self-hosted runners can be created.
  • Manage organization Actions secrets: Access to create and manage Actions organization secrets.
  • Manage organization Actions variables: Access to create and manage Actions organization variables.

For more information, see Managing custom organization roles.