github.com/containers/podman/v5@v5.1.0-rc1/docs/source/markdown/podman-images.1.md.in

% 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 (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: `<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:

| **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          |
| .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 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*).

@@option noheading

#### **--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
<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, 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)](podman.1.md)**, **[containers-storage.conf(5)](https://github.com/containers/storage/blob/main/docs/containers-storage.conf.5.md)**

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