github.com/hanks177/podman/v4@v4.1.3-0.20220613032544-16d90015bc83/docs/source/markdown/podman-images.1.md (about) 1 % podman-images(1) 2 3 ## NAME 4 podman\-images - List images in local storage 5 6 ## SYNOPSIS 7 **podman images** [*options*] 8 9 **podman image list** [*options*] 10 11 **podman image ls** [*options*] 12 13 ## DESCRIPTION 14 Displays locally stored images, their names, and their IDs. 15 16 ## OPTIONS 17 18 #### **--all**, **-a** 19 20 Show all images (by default filter out the intermediate image layers). The default is false. 21 22 #### **--digests** 23 24 Show image digests 25 26 #### **--filter**=*filter*, **-f** 27 28 Provide filter values. 29 30 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*. 31 32 Supported filters: 33 34 | Filter | Description | 35 | :----------------: | --------------------------------------------------------------------------------------------- | 36 | *id* | Filter by image id. | 37 | *before* | Filter by images created before the given IMAGE (name or tag). | 38 | *containers* | Filter by images with a running container. | 39 | *dangling* | Filter by dangling (unused) images. | 40 | *intermediate* | Filter by images that are dangling and have no children | 41 | *label* | Filter by images with (or without, in the case of label!=[...] is used) the specified labels. | 42 | *manifest* | Filter by images that are manifest lists. | 43 | *readonly* | Filter by read-only or read/write images. | 44 | *reference* | Filter by image name. | 45 | *after*/*since* | Filter by images created after the given IMAGE (name or tag). | 46 | *until* | Filter by images created until the given duration or time. | 47 48 The `id` *filter* accepts the image id string. 49 50 The `before` *filter* accepts formats: `<image-name>[:<tag>]`, `<image id>` or `<image@digest>`. 51 52 The `containers` *filter* shows images that have a running container based on that image. 53 54 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. 55 56 The `intermediate` *filter* shows images that are dangling and have no children. 57 58 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. 59 60 The `manifest` *filter* shows images that are manifest lists. 61 62 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. 63 64 The `reference` *filter* accepts the pattern of an image reference `<image-name>[:<tag>]`. 65 66 The `after` or `since` *filter* accepts formats: `<image-name>[:<tag>]`, `<image id>` or `<image@digest>`. 67 68 The `until` *filter* accepts formats: golang duration, RFC3339 time, or a Unix timestamp and shows all images that are created until that time. 69 70 #### **--format**=*format* 71 72 Change the default output format. This can be of a supported type like 'json' 73 or a Go template. 74 Valid placeholders for the Go template are listed below: 75 76 | **Placeholder** | **Description** | 77 | --------------- | ----------------------------------------------------------------------------- | 78 | .ID | Image ID | 79 | .Repository | Image repository | 80 | .Tag | Image tag | 81 | .Digest | Image digest | 82 | .CreatedSince | Elapsed time since the image was created | 83 | .CreatedAt | Time when the image was created | 84 | .Size | Size of layer on disk | 85 | .History | History of the image layer | 86 87 #### **--history** 88 89 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. 90 91 #### **--no-trunc** 92 93 Do not truncate the output (default *false*). 94 95 #### **--noheading**, **-n** 96 97 Omit the table headings from the listing of images. 98 99 #### **--quiet**, **-q** 100 101 Lists only the image IDs. 102 103 #### **--sort**=*sort*=*created* 104 105 Sort by created, id, repository, size or tag (default: created) 106 107 ## EXAMPLE 108 109 ``` 110 # podman images 111 REPOSITORY TAG IMAGE ID CREATED SIZE 112 docker.io/kubernetes/pause latest e3d42bcaf643 3 years ago 251 kB 113 <none> <none> ebb91b73692b 4 weeks ago 27.2 MB 114 docker.io/library/ubuntu latest 4526339ae51c 6 weeks ago 126 MB 115 ``` 116 117 ``` 118 # podman images --quiet 119 e3d42bcaf643 120 ebb91b73692b 121 4526339ae51c 122 ``` 123 124 ``` 125 # podman images --noheading 126 docker.io/kubernetes/pause latest e3d42bcaf643 3 years ago 251 kB 127 <none> <none> ebb91b73692b 4 weeks ago 27.2 MB 128 docker.io/library/ubuntu latest 4526339ae51c 6 weeks ago 126 MB 129 ``` 130 131 ``` 132 # podman images --no-trunc 133 REPOSITORY TAG IMAGE ID CREATED SIZE 134 docker.io/kubernetes/pause latest sha256:e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27 3 years ago 251 kB 135 <none> <none> sha256:ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9 4 weeks ago 27.2 MB 136 docker.io/library/ubuntu latest sha256:4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a 6 weeks ago 126 MB 137 ``` 138 139 ``` 140 # podman images --format "table {{.ID}} {{.Repository}} {{.Tag}}" 141 IMAGE ID REPOSITORY TAG 142 e3d42bcaf643 docker.io/kubernetes/pause latest 143 ebb91b73692b <none> <none> 144 4526339ae51c docker.io/library/ubuntu latest 145 ``` 146 147 ``` 148 # podman images --filter dangling=true 149 REPOSITORY TAG IMAGE ID CREATED SIZE 150 <none> <none> ebb91b73692b 4 weeks ago 27.2 MB 151 ``` 152 153 ``` 154 # podman images --format json 155 [ 156 { 157 "id": "e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27", 158 "names": [ 159 "docker.io/kubernetes/pause:latest" 160 ], 161 "digest": "sha256:0aecf73ff86844324847883f2e916d3f6984c5fae3c2f23e91d66f549fe7d423", 162 "created": "2014-07-19T07:02:32.267701596Z", 163 "size": 250665 164 }, 165 { 166 "id": "ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9", 167 "names": [ 168 "\u003cnone\u003e" 169 ], 170 "digest": "sha256:ba7e4091d27e8114a205003ca6a768905c3395d961624a2c78873d9526461032", 171 "created": "2017-10-26T03:07:22.796184288Z", 172 "size": 27170520 173 }, 174 { 175 "id": "4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a", 176 "names": [ 177 "docker.io/library/ubuntu:latest" 178 ], 179 "digest": "sha256:193f7734ddd68e0fb24ba9af8c2b673aecb0227b026871f8e932dab45add7753", 180 "created": "2017-10-10T20:59:05.10196344Z", 181 "size": 126085200 182 } 183 ] 184 ``` 185 186 ``` 187 # podman images --sort repository 188 REPOSITORY TAG IMAGE ID CREATED SIZE 189 <none> <none> 2460217d76fc About a minute ago 4.41 MB 190 docker.io/library/alpine latest 3fd9065eaf02 5 months ago 4.41 MB 191 localhost/myapp latest b2e0ad03474a About a minute ago 4.41 MB 192 registry.access.redhat.com/rhel7 latest 7a840db7f020 2 weeks ago 211 MB 193 registry.fedoraproject.org/fedora 27 801894bc0e43 6 weeks ago 246 MB 194 ``` 195 196 ``` 197 # podman images 198 REPOSITORY TAG IMAGE ID CREATED SIZE 199 localhost/test latest 18f0c080cd72 4 seconds ago 4.42 MB 200 docker.io/library/alpine latest 3fd9065eaf02 5 months ago 4.41 MB 201 # podman images -a 202 REPOSITORY TAG IMAGE ID CREATED SIZE 203 localhost/test latest 18f0c080cd72 6 seconds ago 4.42 MB 204 <none> <none> 270e70dc54c0 7 seconds ago 4.42 MB 205 <none> <none> 4ed6fbe43414 8 seconds ago 4.41 MB 206 <none> <none> 6b0df8e71508 8 seconds ago 4.41 MB 207 docker.io/library/alpine latest 3fd9065eaf02 5 months ago 4.41 MB 208 ``` 209 210 ## SEE ALSO 211 **[podman(1)](podman.1.md)**, **[containers-storage.conf(5)](https://github.com/containers/storage/blob/main/docs/containers-storage.conf.5.md)** 212 213 ## HISTORY 214 March 2017, Originally compiled by Dan Walsh `<dwalsh@redhat.com>`