1podman-inspect(1)           General Commands Manual          podman-inspect(1)
2
3
4

NAME

6       podman-inspect - Display a container or image's configuration
7
8

SYNOPSIS

10       podman inspect [options] name ...
11
12
13       podman image inspect [options] image
14
15
16       podman container inspect [options] container
17
18

DESCRIPTION

20       This displays the low-level information on containers and images
21       identified by name or ID. By default, this will render all results in a
22       JSON array. If the container and image have the same name, this will
23       return container JSON for unspecified type. If a format is specified,
24       the given template will be executed for each result.
25
26

OPTIONS

28       --type, -t="TYPE"
29
30
31       Return JSON for the specified type.  Type can be 'container', 'image'
32       or 'all' (default: all) (Only meaningful when invoked as podman
33       inspect)
34
35
36       --format, -f="FORMAT"
37
38
39       Format the output using the given Go template.  The keys of the
40       returned JSON can be used as the values for the --format flag (see
41       examples below).
42
43
44       --latest, -l
45
46
47       Instead of providing the container name or ID, use the last created
48       container. If you use methods other than Podman to run containers such
49       as CRI-O, the last started container could be from either of those
50       methods.
51
52
53       The latest option is not supported on the remote client or when invoked
54       as podman image inspect.
55
56
57       --size, -s
58
59
60       Display the total file size if the type is a container
61
62

EXAMPLE

64              # podman inspect fedora
65              {
66                  "Id": "422dc563ca3260ad9ef5c47a1c246f5065d7f177ce51f4dd208efd82967ff182",
67                  "Digest": "sha256:1b9bfb4e634dc1e5c19d0fa1eb2e5a28a5c2b498e3d3e4ac742bd7f5dae08611",
68                  "RepoTags": [
69                      "docker.io/library/fedora:latest"
70                  ],
71                  "RepoDigests": [
72                      "docker.io/library/fedora@sha256:1b9bfb4e634dc1e5c19d0fa1eb2e5a28a5c2b498e3d3e4ac742bd7f5dae08611"
73                  ],
74                  "Parent": "",
75                  "Comment": "",
76                  "Created": "2017-11-14T21:07:08.475840838Z",
77                  "Config": {
78                      "Env": [
79                          "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
80                          "DISTTAG=f27container",
81                          "FGC=f27",
82                          "FBR=f27"
83                      ]
84                  },
85                  "Version": "17.06.2-ce",
86                  "Author": "[Adam Miller \u003cmaxamillion@fedoraproject.org\u003e] [Patrick Uiterwijk \u003cpatrick@puiterwijk.org\u003e]",
87                  "Architecture": "amd64",
88                  "Os": "linux",
89                  "Size": 251722732,
90                  "VirtualSize": 514895140,
91                  "GraphDriver": {
92                      "Name": "overlay",
93                      "Data": {
94                          "MergedDir": "/var/lib/containers/storage/overlay/d32459d9ce237564fb93573b85cbc707600d43fbe5e46e8eeef22cad914bb516/merged",
95                          "UpperDir": "/var/lib/containers/storage/overlay/d32459d9ce237564fb93573b85cbc707600d43fbe5e46e8eeef22cad914bb516/diff",
96                          "WorkDir": "/var/lib/containers/storage/overlay/d32459d9ce237564fb93573b85cbc707600d43fbe5e46e8eeef22cad914bb516/work"
97                      }
98                  },
99                  "RootFS": {
100                      "Type": "layers",
101                      "Layers": [
102                          "sha256:d32459d9ce237564fb93573b85cbc707600d43fbe5e46e8eeef22cad914bb516"
103                      ]
104                  },
105                  "Labels": null,
106                  "Annotations": {}
107              }
108
109
110
111              # podman inspect a04 --format "{{.ImageName}}"
112              fedora
113
114
115
116              # podman inspect a04 --format "{{.GraphDriver.Name}}"
117              overlay
118
119
120
121              # podman image inspect --format "size: {{.Size}}" alpine
122              size:   4405240
123
124
125
126              podman container inspect --latest --format {{.EffectiveCaps}}
127              [CAP_CHOWN CAP_DAC_OVERRIDE CAP_FSETID CAP_FOWNER CAP_MKNOD CAP_NET_RAW CAP_SETGID CAP_SETUID CAP_SETFCAP CAP_SETPCAP CAP_NET_BIND_SERVICE CAP_SYS_CHROOT CAP_KILL CAP_AUDIT_WRITE]
128
129
130

SEE ALSO

132       podman(1)
133
134

HISTORY

136       July 2017, Originally compiled by Dan Walsh ⟨dwalsh@redhat.com⟩
137
138
139
140                                                             podman-inspect(1)
Impressum