Provided by: podman_5.0.3+ds1-5ubuntu1_amd64
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)