Search and Download New Images
Using the Podman page, Cockpit administrators can search and download images from configured Podman registries on the host system.
What Do You Need?
- The Cockpit web console must be installed and accessible.
For details, see these topics: Install and Enable Cockpit and Log in to the Cockpit Web Console.
- The Podman container tools must be installed on the host system. For information on how to install Podman, see Installing Podman and Related Utilities in Oracle Linux: Podman User's Guide.
- The Cockpit-Podman add-on application must be installed. For further information on how to configure the Cockpit web console to interact with Podman, see Install and Configure Cockpit-Podman.
Steps
Using the Cockpit web console, follow these steps to search and download a copy of an image from a Podman configured registry on the host system.
- In the Cockpit navigation pane, click Podman.
The Podman page appears.
- In the Podman page, navigate to the upper right corner of the
Images section, click the actions menu [⋮], and then select
Download new image.
The Search for an image dialog appears.
- In the Search for an image dialog, specify the following
properties and then click Download to download a copy of the image
to the local container image store.
Owner Select one of the following: - System: Download images as a system root user.
Images are by default stored in the
/var/lib/containers
directory. - Username (logged in user): Download images as a
standard user. Images are typically stored in
$HOME/. local/share/containers/storage/
directory.
Search for In the Search for section, perform the following: - Type the name of an image in the first field, and then select the name of
the target registry to conduct the search. A list images appear below the
search fields.
Example: Type Oracle Linux in the first field and select All registries in the second field. A list of all the Oracle Linux images found in all configured registries appear.
- In the list of images, select the image you want to download.
Tag The Tag identifies the image version. If a tag name isn't specified, the default tag latest is appended to the image filename (image:tag). WARNING:
Many tools default to using thelatest
tag if no tag is specified but this can lead to errors and is now considered bad practice.Recommended action:- In the Tag field, enter a unique name that
represents the version of the image.
Example: If the image name is Oracle Linux and you know that the software version is 8, in the tag field you would enter 8 (OracleLinix:8).
For more information about tagging images, see Oracle Linux Container Image Tagging Conventions in Oracle Linux: Podman User's Guide.
- System: Download images as a system root user.
Images are by default stored in the