Enabling improved container support with the Container registry

To use the Container registry, you must enable it for your user or organization account.

GitHub Packages is available with GitHub Free, GitHub Pro, GitHub Free for organizations, GitHub Team, GitHub Enterprise Cloud, GitHub Enterprise Server, and GitHub AE.


GitHub Packages is not available for private repositories owned by accounts using legacy per-repository plans. Also, accounts using legacy per-repository plans cannot access the Container registry since these accounts are billed by repository. For more information, see "GitHub's products."

In this article

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.

  1. In the upper-right corner of any page, click your profile photo, then click Feature preview. Feature preview button
  2. On the left, select "Improved container support", then click Enable. Improved container support

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.

  1. In the top right corner of GitHub, click your profile photo, then click Your organizations. Your organizations in the profile menu
  2. Click Settings next to the organization. The settings button
  3. On the left, click Packages.
  4. Under "Improved container support", select "Enable improved container support" and click Save. Enable container registry support option and save button
  5. 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. Visibility options for container images published by organization members

Did this doc help you?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.