podman-inspect(1)

📦
version 6.1.4 · 20 versions
, in arch rolling

✨ podman-inspect(1) ✨

okay bestie so you're looking at the podman-inspect page from the General Commands Manual and honestly? it's giving "backstage pass to your containers" 💅 let's get into it.

💖 NAME 💖

podman-inspect — display artifact, container, image, volume, network, or pod's configuration

🦋 SYNOPSIS 🦋

podman inspect [options] name [...]

🌸 DESCRIPTION 🌸

okay so this one shows you the low-level info on artifacts, containers, and images that you identify by name or ID. by default it renders all the results in a JSON array, cute and neat ✨

if the inspect type is all, the order of inspection is: containers, images, volumes, network, pods, artifacts. yes that's the order, don't come for me, it's just how it is 🫶

if a container has the same name as an image, then the container JSON is returned, and so on. (so the container wins the name fight, no cap 👑)

and if a format is specified, the given template is executed for each result. every single one. periodt 💅

for more inspection options, see also podman-artifact-inspect(1), podman-container-inspect(1), podman-image-inspect(1), podman-network-inspect(1), podman-pod-inspect(1), and podman-volume-inspect(1). we love a dedicated-page moment 🎀

⭐ 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, they're literally right there bestie 👀)
  • --latest, -l — instead of providing the container name or ID, use the last created container. note: the last started container can be from other users of Podman on the host machine 😭 (also: this option is not available with the remote 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 'artifact', 'container', 'image', 'volume', 'network', 'pod', or 'all' (default: all) (only meaningful when invoked as podman inspect)

🎀 EXAMPLES 🎀

💜 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": []
    }
]

look at all that ✨ it's a lot but it's your lot.

🦋 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 container for the OOMKilled format specifier

podman container inspect myContainer --format {{.State.OOMKilled}}
false

🦋 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
ok so yes, that example says nyNetwork and {{.name}} — lowercase n and everything. it's exactly what the page says, i'm not touching it, i'm just the messenger 💀

🦋 inspect the specified artifact

# podman inspect quay.io/myimage/myartifact:latest --type artifact
{
    "Manifest": {
        "schemaVersion": 2,
        "mediaType": "application/vnd.oci.image.manifest.v1+json",
        ...
    },
    "Name": "quay.io/myimage/myartifact:latest",
    "Digest": "sha256:..."
}

🌈 SEE ALSO 🌈

podman(1), podman-artifact-inspect(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⟩

and that's the whole page bestie, you ate that 🫶💖 this one came to you straight from the General Commands Manual, page podman-inspect(1), with history dating allll the way back to July 2017 — iconic behavior honestly 🌸✨

📦 where this page comes from