podman-inspect(1) General Commands Manual podman-inspect(1)
NAME
podman-inspect - Display a container, image, volume, network, or pod's
configuration
SYNOPSIS
podman inspect [options] name [...]
DESCRIPTION
This displays the low-level information on containers and images identi-
fied by name or ID. By default, this renders all results in a JSON ar-
ray. If the inspect type is all, the order of inspection is: containers,
images, volumes, network, pods.
If a container has the same name as an image, then the container JSON
is returned, and so on.
If a format is specified, the given template is executed for each re-
sult.
For more inspection options, see also podman-container-inspect(1), pod-
man-image-inspect(1), podman-network-inspect(1), podman-pod-inspect(1),
and podman-volume-inspect(1).
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 be-
low).
--latest, -l
Instead of providing the container name or ID, use the last created con-
tainer. Note: the last started container can be from other users of
Podman on the host machine. (This option is not available with the re-
mote Podman client, including Mac and Windows (excluding WSL2) machines)
--size, -s
In addition to normal output, display the total file size if the type is
a container.
--type, -t=type
Return JSON for the specified type. Type can be 'container', 'image',
'volume', 'network', 'pod', or 'all' (default: all) (Only meaningful
when invoked as podman inspect)
EXAMPLE
Inspect the fedora image:
# podman inspect fedora
[
{
"Id": "f0858ad3febdf45bb2e5501cb459affffacef081f79eaa436085c3b6d9bd46ca",
"Digest": "sha256:d4f7df6b691d61af6cee7328f82f1d8afdef63bc38f58516858ae3045083924a",
"RepoTags": [
"docker.io/library/fedora:latest"
],
"RepoDigests": [
"docker.io/library/fedora@sha256:8fa60b88e2a7eac8460b9c0104b877f1aa0cea7fbc03c701b7e545dacccfb433",
"docker.io/library/fedora@sha256:d4f7df6b691d61af6cee7328f82f1d8afdef63bc38f58516858ae3045083924a"
],
"Parent": "",
"Comment": "",
"Created": "2019-10-29T03:23:37.695123423Z",
"Config": {
"Env": [
"PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
"DISTTAG=f31-updates-candidatecontainer",
"FGC=f31-updates-candidate",
"FBR=f31-updates-candidate"
],
"Cmd": [
"/bin/bash"
],
"Labels": {
"maintainer": "Clement Verna \u003ccverna@fedoraproject.org\u003e"
}
},
"Version": "18.06.1-ce",
"Author": "",
"Architecture": "amd64",
"Os": "linux",
"Size": 201096840,
"VirtualSize": 201096840,
"GraphDriver": {
"Name": "overlay",
"Data": {
"UpperDir": "/home/user/.local/share/containers/storage/overlay/2ae3cee18c8ef9e0d448649747dab81c4f1ca2714a8c4550eff49574cab262c9/diff",
"WorkDir": "/home/user/.local/share/containers/storage/overlay/2ae3cee18c8ef9e0d448649747dab81c4f1ca2714a8c4550eff49574cab262c9/work"
}
},
"RootFS": {
"Type": "layers",
"Layers": [
"sha256:2ae3cee18c8ef9e0d448649747dab81c4f1ca2714a8c4550eff49574cab262c9"
]
},
"Labels": {
"maintainer": "Clement Verna \u003ccverna@fedoraproject.org\u003e"
},
"Annotations": {},
"ManifestType": "application/vnd.docker.distribution.manifest.v2+json",
"User": "",
"History": [
{
"created": "2019-01-16T21:21:55.569693599Z",
"created_by": "/bin/sh -c #(nop) LABEL maintainer=Clement Verna \u003ccverna@fedoraproject.org\u003e",
"empty_layer": true
},
{
"created": "2019-09-27T21:21:07.784469821Z",
"created_by": "/bin/sh -c #(nop) ENV DISTTAG=f31-updates-candidatecontainer FGC=f31-updates-candidate FBR=f31-updates-candidate",
"empty_layer": true
},
{
"created": "2019-10-29T03:23:37.355187998Z",
"created_by": "/bin/sh -c #(nop) ADD file:298f828afc880ccde9205fc4418435d5e696ad165e283f0530d0b1a74326d6dc in / "
},
{
"created": "2019-10-29T03:23:37.695123423Z",
"created_by": "/bin/sh -c #(nop) CMD [\"/bin/bash\"]",
"empty_layer": true
}
],
"NamesHistory": []
}
]
Inspect the specified image with the ImageName format specifier:
# podman inspect a04 --format "{{.ImageName}}"
fedora
Inspect the specified image for GraphDriver format specifier:
# podman inspect a04 --format "{{.GraphDriver.Name}}"
overlay
Inspect the specified image for its Size format specifier:
# podman image inspect --format "size: {{.Size}}" alpine
size: 4405240
Inspect the latest container created for EffectiveCaps format specifier.
(This option is not available with the remote Podman client, including
Mac and Windows (excluding WSL2) machines):
podman container inspect --latest --format {{.EffectiveCaps}}
[CAP_CHOWN CAP_DAC_OVERRIDE CAP_FSETID CAP_FOWNER CAP_SETGID CAP_SETUID CAP_SETFCAP CAP_SETPCAP CAP_NET_BIND_SERVICE CAP_KILL]
Inspect the specified pod for the Name format specifier:
# podman inspect myPod --type pod --format "{{.Name}}"
myPod
Inspect the specified volume for the Name format specifier:
# podman inspect myVolume --type volume --format "{{.Name}}"
myVolume
Inspect the specified network for the Name format specifier:
# podman inspect nyNetwork --type network --format "{{.name}}"
myNetwork
SEE ALSO
podman(1), podman-container-inspect(1), podman-image-inspect(1), podman-
network-inspect(1), podman-pod-inspect(1), podman-volume-inspect(1)
HISTORY
July 2017, Originally compiled by Dan Walsh dwalsh@redhat.com
⟨mailto:dwalsh@redhat.com⟩
podman-inspect(1)
Generated by dwww version 1.16 on Tue Dec 16 06:21:16 CET 2025.