podman-images(1) General Commands Manual podman-images(1)
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 (un- │
│ │ used) images. │
├──────────────┼────────────────────────────┤
│ digest │ Filter by digest. │
├──────────────┼────────────────────────────┤
│ intermediate │ Filter by images that are │
│ │ dangling and have no chil- │
│ │ dren │
├──────────────┼────────────────────────────┤
│ 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: <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 chil-
dren.
The label filter accepts two formats. One is the label=key or la-
bel=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 additional-
imagestores 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:
┌───────────────┬───────────────────────────────┐
│ Placeholder │ Description │
├───────────────┼───────────────────────────────┤
│ .Containers │ Number of containers using │
│ │ this image │
├───────────────┼───────────────────────────────┤
│ .Created │ Elapsed time since the image │
│ │ was created │
├───────────────┼───────────────────────────────┤
│ .CreatedAt │ Time when the image was cre- │
│ │ ated, 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 │
├───────────────┼───────────────────────────────┤
│ .SharedSize │ Always seems to be 0 │
├───────────────┼───────────────────────────────┤
│ .Size │ Size of layer on disk (human- │
│ │ friendly string) │
├───────────────┼───────────────────────────────┤
│ .Tag │ Image tag │
├───────────────┼───────────────────────────────┤
│ .VirtualSize │ Size of layer on disk (bytes) │
└───────────────┴───────────────────────────────┘
--history
Display the history of image names. If an image gets re-tagged or un-
tagged, 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
[
{
"id": "e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27",
"names": [
"docker.io/kubernetes/pause:latest"
],
"digest": "sha256:0aecf73ff86844324847883f2e916d3f6984c5fae3c2f23e91d66f549fe7d423",
"created": "2014-07-19T07:02:32.267701596Z",
"size": 250665
},
{
"id": "ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9",
"names": [
"\u003cnone\u003e"
],
"digest": "sha256:ba7e4091d27e8114a205003ca6a768905c3395d961624a2c78873d9526461032",
"created": "2017-10-26T03:07:22.796184288Z",
"size": 27170520
},
{
"id": "4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a",
"names": [
"docker.io/library/ubuntu:latest"
],
"digest": "sha256:193f7734ddd68e0fb24ba9af8c2b673aecb0227b026871f8e932dab45add7753",
"created": "2017-10-10T20:59:05.10196344Z",
"size": 126085200
}
]
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, in-
cluding 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>
podman-images(1)
Generated by dwww version 1.16 on Tue Dec 16 06:01:14 CET 2025.