Enabling improved container support

To use GitHub 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 2.22, GitHub One, 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 GitHub Container Registry since these accounts are billed by repository. For more information, see "GitHub's products."

In this article

Note: GitHub Container Registry is currently in public beta and subject to change. During the beta, storage and bandwidth are free. For more information, see "About GitHub Container Registry."

Enabling GitHub Container Registry for your personal account

Once GitHub Container Registry is enabled for your personal user account, you can publish containers to GitHub Container Registry owned by your user account.

To use GitHub 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 GitHub Container Registry for your organization account

Before organization owners or members can publish container images to GitHub 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 profile.

    Profile photo

  2. On the left side of your profile page, under "Organizations", click the icon for your organization.

    organization icons

  3. Under your organization name, click Settings.

    Organization settings button

  4. On the left, click Packages.

  5. Under "Improved container support", select "Enable improved container support" and click Save.

    Enable container registry support option and save button

  6. Under "Container creation", choose whether you want to enable the creation of public and/or private container images.

    • To enable organization members to create public container images, click Public.
    • To enable organization members to create private container images that are only visible to other organization members, click Private. You can further customize the visibility of private container images. For more information, see "Configuring access control and visibility for container images."

    Options to enable public or private packages

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.