podman image
podman image
https://docs.podman.io/en/v5.1.2/markdown/podman-images.1.html
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:
Filter
Description
id
Filter by image ID.
before
Filter by images created before the given IMAGE (name or tag).
containers
Filter by images with a running container.
dangling
Filter by dangling (unused) images.
digest
Filter by digest.
intermediate
Filter by images that are dangling and have no children
label
Filter by images with (or without, in the case of label!=[…] is used) the specified labels.
manifest
Filter by images that are manifest lists.
readonly
Filter by read-only or read/write images.
reference
Filter by image name.
after/since
Filter by images created after the given IMAGE (name or tag).
until
Filter by images created until the given duration or time.
The id filter accepts the image ID string.
The before filter accepts formats:
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
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
The after or since filter accepts formats:
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:
Placeholder
Description
.Containers
Number of containers using this image
.Created
Elapsed time since the image was created
.CreatedAt
Time when the image was created, YYYY-MM-DD HH:MM:SS +nnnn
.CreatedSince
Same as .Created
.CreatedTime
Same as .CreatedAt
.Dangling
Same as .IsDangling
.Digest
Image digest
.History
History of the image layer
.ID
Image ID (truncated)
.Id
Image ID (full SHA)
.IsDangling
Is image dangling? (true/false)
.IsReadOnly
Is unage read-only? (true/false)
.Labels …
map[] of labels
.Names
Image FQIN
.ParentId
Full SHA of parent image ID, or null (string)
.ReadOnly
Same as .IsReadOnly
.RepoDigests
map[] of zero or more repo/name@sha256:SHA strings
.Repository
Image repository
.RepoTags
map[] of zero or more FQIN strings for this image
.SharedSise
Always seems to be 0
.Sise
Sise of layer on disk (human-friendly string)
.Tag
Image tag
.VirtualSise
Sise of layer on disk (bytes) –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) 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