1podman-image-inspect(1) General Commands Manual podman-image-inspect(1)
2
6 podman-image-inspect - Display an image's configuration
7
10 podman image inspect [options] image [image ...]
11
14 This displays the low-level information on images identified by name or
15 ID. By default, this renders all results in a JSON array. If a format
16 is specified, the given template is executed for each result.
17
20 --format, -f=format
21 Format the output using the given Go template. The keys of the re‐
22 turned JSON can be used as the values for the --format flag (see exam‐
23 ples below).
24 Valid placeholders for the Go template are listed below:
27 ┌─────────────────┬───────────────────────────────┐
30 │Placeholder │ Description │
31 ├─────────────────┼───────────────────────────────┤
32 │.Annotations │ Annotation information in‐ │
33 │ │ cluded in the image │
34 ├─────────────────┼───────────────────────────────┤
35 │.Architecture │ Architecture of software in │
36 │ │ the image │
37 ├─────────────────┼───────────────────────────────┤
38 │.Author │ Image author │
39 ├─────────────────┼───────────────────────────────┤
40 │.Comment │ Image comment │
41 ├─────────────────┼───────────────────────────────┤
42 │.Config ... │ Structure with config info │
43 ├─────────────────┼───────────────────────────────┤
44 │.Created │ Image creation time (string, │
45 │ │ ISO3601) │
46 ├─────────────────┼───────────────────────────────┤
47 │.Digest │ Image digest (sha256:+64-char │
48 │ │ hash) │
49 ├─────────────────┼───────────────────────────────┤
50 │.GraphDriver ... │ Structure for the graph │
51 │ │ driver info │
52 ├─────────────────┼───────────────────────────────┤
53 │.HealthCheck ... │ Structure for the health │
54 │ │ check info │
55 ├─────────────────┼───────────────────────────────┤
56 │.History │ History information stored in │
57 │ │ image │
58 ├─────────────────┼───────────────────────────────┤
59 │.ID │ Image ID (full 64-char hash) │
60 ├─────────────────┼───────────────────────────────┤
61 │.Labels │ Label information included in │
62 │ │ the image │
63 ├─────────────────┼───────────────────────────────┤
64 │.ManifestType │ Manifest type of the image │
65 ├─────────────────┼───────────────────────────────┤
66 │.NamesHistory │ Name history information │
67 │ │ stored in image │
68 ├─────────────────┼───────────────────────────────┤
69 │.Os │ Operating system of software │
70 │ │ in the image │
71 ├─────────────────┼───────────────────────────────┤
72 │.Parent │ Parent image of the specified │
73 │ │ image │
74 ├─────────────────┼───────────────────────────────┤
75 │.RepoDigests │ Repository digests for the │
76 │ │ image │
77 ├─────────────────┼───────────────────────────────┤
78 │.RepoTags │ Repository tags for the image │
79 ├─────────────────┼───────────────────────────────┤
80 │.RootFS ... │ Structure for the root file │
81 │ │ system info │
82 ├─────────────────┼───────────────────────────────┤
83 │.Size │ Size of image, in bytes │
84 ├─────────────────┼───────────────────────────────┤
85 │.User │ Default user to execute the │
86 │ │ image as │
87 ├─────────────────┼───────────────────────────────┤
88 │.Version │ Image Version │
89 ├─────────────────┼───────────────────────────────┤
90 │.VirtualSize │ Virtual size of image, in │
91 │ │ bytes │
92 └─────────────────┴───────────────────────────────┘
93
95 $ podman image inspect fedora
96 [
97 {
98 "Id": "37e5619f4a8ca9dbc4d6c0ae7890625674a10dbcfb76201399e2aaddb40da17d",
99 "Digest": "sha256:1b0d4ddd99b1a8c8a80e885aafe6034c95f266da44ead992aab388e6aa91611a",
100 "RepoTags": [
101 "registry.fedoraproject.org/fedora:latest"
102 ],
103 "RepoDigests": [
104 "registry.fedoraproject.org/fedora@sha256:1b0d4ddd99b1a8c8a80e885aafe6034c95f266da44ead992aab388e6aa91611a",
105 "registry.fedoraproject.org/fedora@sha256:b5290db40008aae9272ad3a6bd8070ef7ecd547c3bef014b894c327960acc582"
106 ],
107 "Parent": "",
108 "Comment": "Created by Image Factory",
109 "Created": "2021-08-09T05:48:47Z",
110 "Config": {
111 "Env": [
112 "DISTTAG=f34container",
113 "FGC=f34",
114 "container=oci"
115 ],
116 "Cmd": [
117 "/bin/bash"
118 ],
119 "Labels": {
120 "license": "MIT",
121 "name": "fedora",
122 "vendor": "Fedora Project",
123 "version": "34"
124 }
125 },
126 "Version": "1.10.1",
127 "Author": "",
128 "Architecture": "amd64",
129 "Os": "linux",
130 "Size": 183852302,
131 "VirtualSize": 183852302,
132 "GraphDriver": {
133 "Name": "overlay",
134 "Data": {
135 "UpperDir": "/home/dwalsh/.local/share/containers/storage/overlay/0203e243f1ca4b6bb49371ecd21363212467ec6d7d3fa9f324cd4e78cc6b5fa2/diff",
136 "WorkDir": "/home/dwalsh/.local/share/containers/storage/overlay/0203e243f1ca4b6bb49371ecd21363212467ec6d7d3fa9f324cd4e78cc6b5fa2/work"
137 }
138 },
139 "RootFS": {
140 "Type": "layers",
141 "Layers": [
142 "sha256:0203e243f1ca4b6bb49371ecd21363212467ec6d7d3fa9f324cd4e78cc6b5fa2"
143 ]
144 },
145 "Labels": {
146 "license": "MIT",
147 "name": "fedora",
148 "vendor": "Fedora Project",
149 "version": "34"
150 },
151 "Annotations": {},
152 "ManifestType": "application/vnd.docker.distribution.manifest.v2+json",
153 "User": "",
154 "History": [
155 {
156 "created": "2021-08-09T05:48:47Z",
157 "comment": "Created by Image Factory"
158 }
159 ],
160 "NamesHistory": [
161 "registry.fedoraproject.org/fedora:latest"
162 ]
163 }
164 ]
165 $ podman image inspect --format '{{ .Id }}' fedora
168 37e5619f4a8ca9dbc4d6c0ae7890625674a10dbcfb76201399e2aaddb40da17d
169
173 podman(1), podman-image(1), podman-inspect(1)
174
177 Sep 2021, Originally compiled by Dan Walsh dwalsh@redhat.com
178 ⟨mailto:dwalsh@redhat.com⟩
179 podman-image-inspect(1)