Note: GitHub Packages is currently in beta for GitHub Enterprise Server 2.22. To join the beta for your instance, use the sign-up form.
GitHub Packages on GitHub Enterprise Server uses external blob storage to store your packages. The amount of storage required depends on your usage of GitHub Packages.
At this time, GitHub Packages supports blob storage with Amazon Web Services (AWS) S3. MinIO is also supported, but configuration is not currently implemented in the GitHub Enterprise Server interface. You can use MinIO for storage by following the instructions for AWS S3, entering the analogous information for your MinIO configuration. Before configuring third-party storage for GitHub Packages on GitHub, you must set up a bucket with your third-party storage provider. For more information on installing and running a MinIO bucket to use with GitHub Packages, see the "Quickstart for configuring MinIO storage."
For the best experience, we recommend using a dedicated bucket for GitHub Packages, separate from the bucket you use for GitHub Actions storage.
- It's critical you set the restrictive access policies you want for your storage bucket because GitHub does not apply specific object permissions or additional access control lists (ACLs) to your storage bucket configuration. For example, if you make your bucket public, data in the bucket will be accessible on the public internet. For more information, see Setting bucket and object access permissions in the AWS Documentation.
- We recommend using a dedicated bucket for GitHub Packages, separate from the bucket you use for GitHub Actions storage.
- Make sure to configure the bucket you'll want to use in the future. We do not recommend changing your storage after you start using GitHub Packages.
Before you configure AWS as storage for GitHub Packages, make sure your AWS access key ID and secret have the following permissions:
- From an administrative account on GitHub Enterprise Server, click in the upper-right corner of any page.
- In the left sidebar, click Management Console.
- In the left sidebar, click Packages.
- Under "AWS Service URL", type the S3 endpoint URL for your bucket's region.
- Under "AWS S3 Bucket", type the name of the S3 bucket you want to use to store package artifacts.
- Under "AWS S3 Access Key", type your access key for S3.
- Under "AWS S3 Secret Key", type your secret key for S3.
- Under "AWS S3 Region", type your region for S3.
- Under the left sidebar, click Save settings.
- Wait for the configuration run to complete.