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¶
HISTORY¶
Sep 2021, Originally compiled by Dan Walsh dwalsh@redhat.com