podman-image-inspect(1)     General Commands Manual    podman-image-inspect(1)

NAME
       podman-image-inspect - Display an image's configuration


SYNOPSIS
       podman image inspect [options] image [image ...]


DESCRIPTION
       This displays the low-level information on images identified by name or
       ID. By default, this renders all results in a JSON array.  If a format
       is specified, the given template is executed for each result.


OPTIONS
   --format, -f=format
       Format the output using the given Go template.  The keys of the
       returned JSON can be used as the values for the --format flag (see
       examples below).


       Valid placeholders for the Go template are listed below:


       +-----------------+-------------------------------+
       |Placeholder      | Description                   |
       +-----------------+-------------------------------+
       |.Annotations ... | Annotation information        |
       |                 | included in the image         |
       +-----------------+-------------------------------+
       |.Architecture    | Architecture of software in   |
       |                 | the image                     |
       +-----------------+-------------------------------+
       |.Author          | Image author                  |
       +-----------------+-------------------------------+
       |.Comment         | Image comment                 |
       +-----------------+-------------------------------+
       |.Config ...      | Structure with config info    |
       +-----------------+-------------------------------+
       |.Created ...     | Image creation time (string,  |
       |                 | ISO3601)                      |
       +-----------------+-------------------------------+
       |.Digest          | Image digest (sha256:+64-char |
       |                 | hash)                         |
       +-----------------+-------------------------------+
       |.GraphDriver ... | Structure for the graph       |
       |                 | driver info                   |
       +-----------------+-------------------------------+
       |.HealthCheck ... | Structure for the health      |
       |                 | check info                    |
       +-----------------+-------------------------------+
       |.History         | History information stored in |
       |                 | image                         |
       +-----------------+-------------------------------+
       |.ID              | Image ID (full 64-char hash)  |
       +-----------------+-------------------------------+
       |.Labels ...      | Label information included in |
       |                 | the image                     |
       +-----------------+-------------------------------+
       |.ManifestType    | Manifest type of the image    |
       +-----------------+-------------------------------+
       |.NamesHistory    | Name history information      |
       |                 | stored in image               |
       +-----------------+-------------------------------+
       |.Os              | Operating system of software  |
       |                 | in the image                  |
       +-----------------+-------------------------------+
       |.Parent          | Parent image of the specified |
       |                 | image                         |
       +-----------------+-------------------------------+
       |.RepoDigests     | Repository digests for the    |
       |                 | image                         |
       +-----------------+-------------------------------+
       |.RepoTags        | Repository tags for the image |
       +-----------------+-------------------------------+
       |.RootFS ...      | Structure for the root file   |
       |                 | system info                   |
       +-----------------+-------------------------------+
       |.Size            | Size of image, in bytes       |
       +-----------------+-------------------------------+
       |.User            | Default user to execute the   |
       |                 | image as                      |
       +-----------------+-------------------------------+
       |.Version         | Image Version                 |
       +-----------------+-------------------------------+
       |.VirtualSize     | Virtual size of image, in     |
       |                 | bytes                         |
       +-----------------+-------------------------------+

EXAMPLE
       Inspect information on the specified image:

       $ podman image inspect fedora
       [
           {
               "Id": "37e5619f4a8ca9dbc4d6c0ae7890625674a10dbcfb76201399e2aaddb40da17d",
               "Digest": "sha256:1b0d4ddd99b1a8c8a80e885aafe6034c95f266da44ead992aab388e6aa91611a",
               "RepoTags": [
                   "registry.fedoraproject.org/fedora:latest"
               ],
               "RepoDigests": [
                   "registry.fedoraproject.org/fedora@sha256:1b0d4ddd99b1a8c8a80e885aafe6034c95f266da44ead992aab388e6aa91611a",
                   "registry.fedoraproject.org/fedora@sha256:b5290db40008aae9272ad3a6bd8070ef7ecd547c3bef014b894c327960acc582"
               ],
               "Parent": "",
               "Comment": "Created by Image Factory",
               "Created": "2021-08-09T05:48:47Z",
               "Config": {
                   "Env": [
                       "DISTTAG=f34container",
                       "FGC=f34",
                       "container=oci"
                   ],
                   "Cmd": [
                       "/bin/bash"
                   ],
                   "Labels": {
                       "license": "MIT",
                       "name": "fedora",
                       "vendor": "Fedora Project",
                       "version": "34"
                   }
               },
               "Version": "1.10.1",
               "Author": "",
               "Architecture": "amd64",
               "Os": "linux",
               "Size": 183852302,
               "VirtualSize": 183852302,
               "GraphDriver": {
                   "Name": "overlay",
                   "Data": {
                       "UpperDir": "/home/dwalsh/.local/share/containers/storage/overlay/0203e243f1ca4b6bb49371ecd21363212467ec6d7d3fa9f324cd4e78cc6b5fa2/diff",
                       "WorkDir": "/home/dwalsh/.local/share/containers/storage/overlay/0203e243f1ca4b6bb49371ecd21363212467ec6d7d3fa9f324cd4e78cc6b5fa2/work"
                   }
               },
               "RootFS": {
                   "Type": "layers",
                   "Layers": [
                       "sha256:0203e243f1ca4b6bb49371ecd21363212467ec6d7d3fa9f324cd4e78cc6b5fa2"
                   ]
               },
               "Labels": {
                   "license": "MIT",
                   "name": "fedora",
                   "vendor": "Fedora Project",
                   "version": "34"
               },
               "Annotations": {},
               "ManifestType": "application/vnd.docker.distribution.manifest.v2+json",
               "User": "",
               "History": [
                   {
                       "created": "2021-08-09T05:48:47Z",
                       "comment": "Created by Image Factory"
                   }
               ],
               "NamesHistory": [
                   "registry.fedoraproject.org/fedora:latest"
               ]
           }
       ]



       Inspect image ID for the specified image:

       $ podman image inspect --format '{{ .Id }}' fedora
       37e5619f4a8ca9dbc4d6c0ae7890625674a10dbcfb76201399e2aaddb40da17d



SEE ALSO
       podman(1), podman-image(1), podman-inspect(1)


HISTORY
       Sep 2021, Originally compiled by Dan Walsh dwalsh@redhat.com
       <mailto:dwalsh@redhat.com>

                                                       podman-image-inspect(1)