Allow users to pull images

Estimated reading time: 1 minute

This topic applies to Docker Enterprise.

The Docker Enterprise platform business, including products, customers, and employees, has been acquired by Mirantis, inc., effective 13-November-2019. For more information on the acquisition and how it may affect you and your business, refer to the Docker Enterprise Customer FAQ.

By default only admin users can pull images into a cluster managed by UCP.

Images are a shared resource, as such they are always in the swarm collection. To allow users access to pull images, you need to grant them the image load permission for the swarm collection.

As an admin user, go to the UCP web UI, navigate to the Roles page, and create a new role named Pull images.

Then go to the Grants page, and create a new grant with:

  • Subject: the user you want to be able to pull images.
  • Roles: the “Pull images” role you created.
  • Resource set: the swarm collection.

Once you click Create the user is able to pull images from the UCP web UI or the CLI.

Where to go next

ucp, grant, images