podman-images.1

podman-images

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLE
SEE ALSO
HISTORY

---

NAME

podman-images − List images in local storage

SYNOPSIS

podman images [options] [image]

podman image list [options] [image]

podman image ls [options] [image]

DESCRIPTION

Displays locally stored images, their names, and their IDs.

OPTIONS

—all, -a

Show all images (by default filter out the intermediate image layers). The default is false.

—digests

Show image digests

—filter, -f=filter

Provide filter values.

The filters argument format is of key=value or key!=value. If there is more than one filter, then pass multiple OPTIONS: —filter foo=bar —filter bif=baz.

Supported filters:

The id filter accepts the image ID string.

The before filter accepts formats: <image-name>[:<tag>], <image id> or <image@digest>.

The containers filter shows images that have a running container based on that image.

The dangling filter shows images that are taking up disk space and serve no purpose. Dangling image is a file system layer that was used in a previous build of an image and is no longer referenced by any image. They are denoted with the <none> tag, consume disk space and serve no active purpose.

The digest filter accepts the image digest string.

The intermediate filter shows images that are dangling and have no children.

The label filter accepts two formats. One is the label=key or label=key=value, which shows images with the specified labels. The other format is the label!=key or label!=key=value, which shows images without the specified labels.

The manifest filter shows images that are manifest lists.

The readonly filter shows, as a default, both read-only and read/write images. Read-only images can be configured by modifying the additionalimagestores in the /etc/containers/storage.conf file.

The reference filter accepts the pattern of an image reference <image-name>[:<tag>].

The after or since filter accepts formats: <image-name>[:<tag>], <image id> or <image@digest>.

The until filter accepts formats: golang duration, RFC3339 time, or a Unix timestamp and shows all images that are created until that time.

—format=format

Change the default output format. This can be of a supported type like ’json’ or a Go template. Valid placeholders for the Go template are listed below:

—history

Display the history of image names. If an image gets re-tagged or untagged, then the image name history gets prepended (latest image first). This is especially useful when undoing a tag operation or an image does not contain any name because it has been untagged.

—no-trunc

Do not truncate the output (default false).

—noheading, -n

Omit the table headings from the listing.

—quiet, -q

Lists only the image IDs.

—sort=sort

Sort by created, id, repository, size or tag (default: created) When sorting by repository it also sorts by the tag as second criteria to provide a stable output.

EXAMPLE

List all non-dangling images in local storage:

$ podman images
REPOSITORY TAG IMAGE ID CREATED SIZE
quay.io/podman/stable latest e0b7dabc3352 22 hours ago 331 MB
docker.io/library/alpine latest 9c6f07244728 5 days ago 5.83 MB
registry.fedoraproject.org/fedora latest 2ecb6df95994 3 weeks ago 169 MB
quay.io/libpod/testimage 20220615 f26aa69bb3f3 2 months ago 8.4 MB

List all images matching the specified name:

$ podman images stable
REPOSITORY TAG IMAGE ID CREATED SIZE
quay.io/podman/stable latest e0b7dabc3352 22 hours ago 331 MB

List image ids of all images in containers storage:

podman image ls —quiet

e3d42bcaf643
ebb91b73692b
4526339ae51c

List all images without showing the headers:

podman images —noheading

docker.io/kubernetes/pause latest e3d42bcaf643 3 years ago 251 kB
<none> <none> ebb91b73692b 4 weeks ago 27.2 MB
docker.io/library/ubuntu latest 4526339ae51c 6 weeks ago 126 MB

List all images without truncating output:

podman image list —no-trunc

REPOSITORY TAG IMAGE ID CREATED SIZE
docker.io/kubernetes/pause latest sha256:e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27 3 years ago 251 kB
<none> <none> sha256:ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9 4 weeks ago 27.2 MB
docker.io/library/ubuntu latest sha256:4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a 6 weeks ago 126 MB

List all image content with the formatted content:

podman images —format “table {{.ID}} {{.Repository}} {{.Tag}}”

IMAGE ID REPOSITORY TAG
e3d42bcaf643 docker.io/kubernetes/pause latest
ebb91b73692b <none> <none>
4526339ae51c docker.io/library/ubuntu latest

List any image that is not tagged with a name (dangling):

podman images —filter dangling=true

REPOSITORY TAG IMAGE ID CREATED SIZE
<none> <none> ebb91b73692b 4 weeks ago 27.2 MB

List all images in JSON format:

podman images —format json

[
{

},
{

},
{

}
]

List all images sorted by the specified column:

podman images —sort repository

REPOSITORY TAG IMAGE ID CREATED SIZE
<none> <none> 2460217d76fc About a minute ago 4.41 MB
docker.io/library/alpine latest 3fd9065eaf02 5 months ago 4.41 MB
localhost/myapp latest b2e0ad03474a About a minute ago 4.41 MB
registry.access.redhat.com/rhel7 latest 7a840db7f020 2 weeks ago 211 MB
registry.fedoraproject.org/fedora 27 801894bc0e43 6 weeks ago 246 MB

Show the difference between listed images in use versus all images, including dangling images:

podman images

REPOSITORY TAG IMAGE ID CREATED SIZE
localhost/test latest 18f0c080cd72 4 seconds ago 4.42 MB
docker.io/library/alpine latest 3fd9065eaf02 5 months ago 4.41 MB

podman images -a

REPOSITORY TAG IMAGE ID CREATED SIZE
localhost/test latest 18f0c080cd72 6 seconds ago 4.42 MB
<none> <none> 270e70dc54c0 7 seconds ago 4.42 MB
<none> <none> 4ed6fbe43414 8 seconds ago 4.41 MB
<none> <none> 6b0df8e71508 8 seconds ago 4.41 MB
docker.io/library/alpine latest 3fd9065eaf02 5 months ago 4.41 MB

SEE ALSO

podman(1), containers-storage.conf(5)

Troubleshooting

See podman-troubleshooting(7) for solutions to common issues.

HISTORY

March 2017, Originally compiled by Dan Walsh <dwalsh@redhat.com>

---