Your company here — click to reach over 10,000 unique daily visitors

podman-image-inspect - Man Page

Display an image's configuration


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


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.


--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:

.Annotations ...Annotation information included in the image
.ArchitectureArchitecture of software in the image
.AuthorImage author
.CommentImage comment
.Config ...Structure with config info
.Created ...Image creation time (string, ISO3601)
.DigestImage digest (sha256:+64-char hash)
.GraphDriver ...Structure for the graph driver info
.HealthCheck ...Structure for the health check info
.HistoryHistory information stored in image
.IDImage ID (full 64-char hash)
.Labels ...Label information included in the image
.ManifestTypeManifest type of the image
.NamesHistoryName history information stored in image
.OsOperating system of software in the image
.ParentParent image of the specified image
.RepoDigestsRepository digests for the image
.RepoTagsRepository tags for the image
.RootFS ...Structure for the root file system info
.SizeSize of image, in bytes
.UserDefault user to execute the image as
.VersionImage Version
.VirtualSizeVirtual size of image, in bytes


Inspect information on the specified image:

$ podman image inspect fedora
        "Id": "37e5619f4a8ca9dbc4d6c0ae7890625674a10dbcfb76201399e2aaddb40da17d",
        "Digest": "sha256:1b0d4ddd99b1a8c8a80e885aafe6034c95f266da44ead992aab388e6aa91611a",
        "RepoTags": [
        "RepoDigests": [
        "Parent": "",
        "Comment": "Created by Image Factory",
        "Created": "2021-08-09T05:48:47Z",
        "Config": {
            "Env": [
            "Cmd": [
            "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": [
        "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": [

Inspect image ID for the specified image:

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

See Also

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


Sep 2021, Originally compiled by Dan Walsh dwalsh@redhat.com ⟨mailto:dwalsh@redhat.com⟩

Referenced By

podman-image(1), podman-inspect(1).

The man page docker-image-inspect(1) is an alias of podman-image-inspect(1).