Explore the Images view in Docker Desktop
TheImagesview lets you manage Docker images without having to use the CLI. By default, it displays a list of all Docker images on your local disk.
You can also view Hub images once you have signed in to Docker Hub. This allows you to collaborate with your team and manage your images directly through Docker Desktop.
TheImagesview lets you perform core operations such as running an image as a container, pulling the latest version of an image from Docker Hub, pushing the image to Docker Hub, and inspecting images.
It also displays metadata about the image such as the:
- Tag
- Image ID
- Date created
- Size of the image.
AnIn Usetag displays next to images used by running and stopped containers. You can choose what information you want displayed by selecting theMore optionsmenu to the right of the search bar, and then use the toggle switches according to your preferences.
TheImages on diskstatus bar displays the number of images and the total disk space used by the images and when this information was last refreshed.
Manage your images
Use theSearchfield to search for any specific image.
You can sort images by:
- In use
- Unused
- Dangling
Run an image as a container
From theImages view,hover over an image and selectRun.
When prompted you can either:
- Select theOptional settingsdrop-down to specify a name, port, volumes, environment variables and selectRun
- SelectRunwithout specifying any optional settings.
Inspect an image
To inspect an image, select the image row. Inspecting an image displays detailed information about the image such as the:
- Image history
- Image ID
- Date the image was created
- Size of the image
- Layers making up the image
- Base images used
- Vulnerabilities found
- Packages inside the image
Docker Scoutpowers this vulnerability information. For more information about this view, see Image details view
Pull the latest image from Docker Hub
Select the image from the list, select theMore optionsbutton and selectPull.
Note
The repository must exist on Docker Hub in order to pull the latest version of an image. You must be signed in to pull private images.
Push an image to Docker Hub
Select the image from the list, select theMore optionsbutton and selectPush to Hub.
Note
You can only push an image to Docker Hub if the image belongs to your Docker ID or your organization. That is, the image must contain the correct username/organization in its tag to be able to push it to Docker Hub.
Remove an image
Note
To remove an image used by a running or a stopped container, you must first remove the associated container.
An unused image is an image which is not used by any running or stopped containers. An image becomes dangling when you build a new version of the image with the same tag.
To remove individual images, select the bin icon.
Docker Hub repositories
TheImagesview also allows you to manage and interact with images in Docker Hub repositories. By default, when you go toImagesin Docker Desktop, you see a list of images that exist in your local image store. TheLocalandHubtabs near the top toggles between viewing images in your local image store, and images in remote Docker Hub repositories that you have access to.
Switching to theHubtab prompts you to sign in to your Docker Hub account, if you're not already signed in. When signed in, it shows you a list of images in Docker Hub organizations and repositories that you have access to.
Select an organization from the drop-down to view a list of repositories for that organization.
If you have enabled Docker Scouton the repositories, image analysis results appear next to the image tags.
Hovering over an image tag reveals two options:
- Pull:Pull the latest version of the image from Docker Hub.
- View in Hub:Open the Docker Hub page and display detailed information about the image.