Note: GitHub Actions was available for GitHub Enterprise Server 2.22 as a limited beta. The beta has ended. GitHub Actions is now generally available in GitHub Enterprise Server 3.0 or later. For more information, see the GitHub Enterprise Server 3.0 release notes.
Note: GitHub-hosted runners are not currently supported on GitHub Enterprise Server. You can see more information about planned future support on the GitHub public roadmap.
Note: GitHub Actions was available for GitHub Enterprise Server 2.22 as a limited beta. If you're upgrading an existing GitHub Enterprise Server instance to 3.0 or later and want to configure GitHub Actions, note that the minimum hardware requirements have increased. For more information, see "Upgrading GitHub Enterprise Server."
The CPU and memory resources available to your GitHub Enterprise Server instance determine the maximum job throughput for GitHub Actions.
Internal testing at GitHub demonstrated the following maximum throughput for GitHub Enterprise Server instances with a range of CPU and memory configurations. You may see different throughput depending on the overall levels of activity on your instance.
|vCPUs||Memory||Maximum job throughput|
|4||32 GB||Demo or light testing|
|8||64 GB||25 jobs|
|16||160 GB||35 jobs|
|32||256 GB||100 jobs|
If you enabled the beta of GitHub Actions for the users of an existing instance, review the levels of activity for users and automations on the instance and ensure that you have provisioned adequate CPU and memory for your users. For more information about monitoring the capacity and performance of GitHub Enterprise Server, see "Monitoring your appliance."
For more information about minimum hardware requirements for your GitHub Enterprise Server instance, see the hardware considerations for your instance's platform.
To enable GitHub Actions on GitHub Enterprise Server, you must have access to external blob storage.
GitHub Actions uses blob storage to store artifacts generated by workflow runs, such as workflow logs and user-uploaded build artifacts. The amount of storage required depends on your usage of GitHub Actions. Only a single external storage configuration is supported, and you can't use multiple storage providers at the same time.
GitHub Actions supports these storage providers:
- Azure Blob storage
- Amazon S3
- S3-compatible MinIO Gateway for NAS
Note: These are the only storage providers that GitHub supports and can provide assistance with. Other S3 API-compatible storage providers are unlikely to work due to differences from the S3 API. Contact us to request support for additional storage providers.
GitHub Actions requires the following permissions for the access key that will access the bucket:
GitHub Actions support on GitHub Enterprise Server 2.22 was available as a limited beta. To configure GitHub Actions for your instance, upgrade to GitHub Enterprise Server 3.0 or later. For more information, see the GitHub Enterprise Server 3.0 release notes and "Upgrading GitHub Enterprise Server."
- "Hardware considerations" for your platform in "Setting up a GitHub Enterprise Server instance"
If GitHub Actions is enabled for your enterprise, only HTTP proxies are supported. SOCK5 and HTTPS proxies and Polipo are not supported. For more information about using a proxy with GitHub Enterprise Server, see "Configuring an outbound web proxy server."
When you enable GitHub Actions for your enterprise, two organizations are created:
actions. If your enterprise already uses the
github organization name,
github-org is also in use) will be used instead. If your enterprise already uses the
actions organization name,
github-actions is also in use) will be used instead. Once actions is enabled, you won't be able to use these names anymore.