podman-inspect man page

podman-inspect — Display a container or image's configuration


podman inspect [options] name ...


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


--type, t="TYPE"
Return JSON for the specified type.  Type can be 'container', 'image' or 'all' (default: all)
--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).
--latest, -l
Instead of providing the container name or ID, use the last created container. If you use methods other than Podman to run containers such as CRI-O, the last started container could be from either of those methods.
Display the total file size if the type is a container


# podman inspect fedora
    "Id": "422dc563ca3260ad9ef5c47a1c246f5065d7f177ce51f4dd208efd82967ff182",
    "Digest": "sha256:1b9bfb4e634dc1e5c19d0fa1eb2e5a28a5c2b498e3d3e4ac742bd7f5dae08611",
    "RepoTags": [
    "RepoDigests": [
    "Parent": "",
    "Comment": "",
    "Created": "2017-11-14T21:07:08.475840838Z",
    "ContainerConfig": {
        "Env": [
    "Version": "17.06.2-ce",
    "Author": "[Adam Miller \u003cmaxamillion@fedoraproject.org\u003e] [Patrick Uiterwijk \u003cpatrick@puiterwijk.org\u003e]",
    "Architecture": "amd64",
    "Os": "linux",
    "Size": 251722732,
    "VirtualSize": 514895140,
    "GraphDriver": {
        "Name": "overlay",
        "Data": {
            "MergedDir": "/var/lib/containers/storage/overlay/d32459d9ce237564fb93573b85cbc707600d43fbe5e46e8eeef22cad914bb516/merged",
            "UpperDir": "/var/lib/containers/storage/overlay/d32459d9ce237564fb93573b85cbc707600d43fbe5e46e8eeef22cad914bb516/diff",
            "WorkDir": "/var/lib/containers/storage/overlay/d32459d9ce237564fb93573b85cbc707600d43fbe5e46e8eeef22cad914bb516/work"
    "RootFS": {
        "Type": "layers",
        "Layers": [
    "Labels": null,
    "Annotations": {}
# podman inspect a04 --format "{{.ImageName}}"
# podman inspect a04 --format "{{.GraphDriver.Name}}"
# podman inspect --format "size: {{.Size}}" alpine
size:   4405240

See Also



July 2017, Originally compiled by Dan Walsh  ⟨dwalsh@redhat.com⟩

Referenced By

podman(1), podman-container(1), podman-image(1), podman-port(1).

The man pages podman-container-inspect(1) and podman-image-inspect(1) are aliases of podman-inspect(1).