Note: The Container registry is currently in public beta and subject to change. During the beta, storage and bandwidth are free. For more information, see "Introduction to GitHub Packages."
Comparing the Docker registry and the Container registry:
- The Container registry (
https://ghcr.io) offers improved performance for containers and will supercede the Docker registry in the future. - You can migrate your Docker images and workflows from the Docker registry (
docker.pkg.github.com) to the Container registry (https://ghcr.io) for granular permissions, container storage optimization, and more. For more information, see "Migrating to the Container registry from the Docker registry."
Enabling the Container registry for your personal account
Once the Container registry is enabled for your personal user account, you can publish containers to the Container registry owned by your user account.
To use the Container registry within an organization, the organization owner must enable the feature for organization members.
- In the upper-right corner of any page, click your profile photo, then click Feature preview.
- On the left, select "Improved container support", then click Enable.
Enabling the Container registry for your organization account
Before organization owners or members can publish container images to the Container registry, an organization owner must enable the feature preview for the organization.
- In the top right corner of GitHub, click your profile photo, then click Your organizations.
- Click Settings next to the organization.
- On the left, click Packages.
- Under "Improved container support", select "Enable improved container support" and click Save.
- Under "Container creation", choose whether you want to enable the creation of public, private, or internal container images.
- To enable organization members to create public container images, select Public.
- To enable organization members to create private container images that are only visible to other organization members, select Private. You can further customize the visibility of private container images. For more information, see "Configuring a package's access control and visibility."
- For GitHub Enterprise Cloud only: To enable organization members to create internal container images that are only visible to other organization members, select Internal.
