Configuring access control and visibility for container images

Configuring access to container images for your personal account

If you have admin permissions to a user-account owned container image, you can assign read, write, or admin roles to other users. For more information about these permission roles, see "Visibility and access permissions for container images."

1. On GitHub, navigate to the main page of your user account.
2. In the top right corner of GitHub, click your profile photo, then click Your profile.
   
3. On your profile page, in the top right, click Packages.
   
4. Search for and select your package.
5. In the top right of your container image's landing page, click Package settings.
   
6. On the package settings page, click Invite teams or people and enter the name, username, or email of the person you want to give access. Teams cannot be given access to a container image owned by a user account.
   
7. Next to the username or team name, use the "Role" drop-down menu to select a desired permission level.
   

The selected users will automatically be given access and don't need to accept an invitation first.

Configuring access to container images for an organization

If you have admin permissions to an organization-owned container image, you can assign read, write, or admin roles to other users and teams. For more information about these permission roles, see "Visibility and access permissions for container images."

If your package is owned by an organization and private, then you can only give access to other organization members or teams.

For organization image containers, organizations admins must enable packages before you can set the visibility to public. For more information, see "Enabling improved container support."

1. On GitHub, navigate to the main page of your organization.
2. Under your organization name, click Packages.
   
3. Search for and select your package.
4. In the top right of your container image's landing page, click Package settings.
   
5. On the package settings page, click Invite teams or people and enter the name, username, or email of the person you want to give access. You can also enter a team name from the organization to give all team members access.
   
6. Next to the username or team name, use the "Role" drop-down menu to select a desired permission level.
   

The selected users or teams will automatically be given access and don't need to accept an invitation first.

Configuring visibility of container images for your personal account

When you first publish a package, the default visibility is private and only you can see the package. You can modify a private or public container image's access by changing the access settings.

A public package can be accessed anonymously without authentication. Once you make your package public, you cannot make your package private again.

1. On GitHub, navigate to the main page of your user account.

2. In the top right corner of GitHub, click your profile photo, then click Your profile.

   

3. On your profile page, in the top right, click Packages.

   

4. Search for and select your package.

5. In the top right of your container image's landing page, click Package settings.

   

6. Under "Danger Zone", choose a visibility setting:

   • To make the container image visible to anyone, click Make public.

     Warning: Once you make a package public, you cannot make it private again.

   • To make the container image visible to a custom selection of people, click Make private.

     

Configuring visibility of container images for an organization

When you first publish a package, the default visibility is private and only you can see the package. You can grant users or teams different access roles for your container image through the access settings.

A public package can be accessed anonymously without authentication. Once you make your package public, you cannot make your package private again.

For organization image containers, organizations admins must enable public packages before you can set the visibility to public. For more information, see "Enabling improved container support."

1. On GitHub, navigate to the main page of your organization.

2. Under your organization name, click Packages.

   

3. Search for and select your package.

4. In the top right of your container image's landing page, click Package settings.

   

5. Under "Danger Zone", choose a visibility setting:

   • To make the container image visible to anyone, click Make public.

     Warning: Once you make a package public, you cannot make it private again.

   • To make the container image visible to a custom selection of people, click Make private.