'\" t
.nh
.TH podman-image-inspect 1
.SH NAME
.PP
podman-image-inspect - Display an image's configuration

.SH SYNOPSIS
.PP
\fBpodman image inspect\fP [\fIoptions\fP] \fIimage\fP [\fIimage\fP ...]

.SH DESCRIPTION
.PP
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.

.SH OPTIONS
.SS \fB--format\fP, \fB-f\fP=\fIformat\fP
.PP
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).

.PP
Valid placeholders for the Go template are listed below:

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

.SH EXAMPLE
.EX
$ 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"
        ]
    }
]
.EE

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

.SH SEE ALSO
.PP
\fBpodman(1)\fP, \fBpodman-image(1)\fP, \fBpodman-inspect(1)\fP

.SH HISTORY
.PP
Sep 2021, Originally compiled by Dan Walsh dwalsh@redhat.com
\[la]mailto:dwalsh@redhat.com\[ra]