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 the `latest` 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.

The Search for image dialog closes and the name of the downloaded image appears in the Images table on the Podman page.