Install Now
podman-container-inspect - Display a container's configuration
Contents
Description
This displays the low-level information on containers identified by name or ID. By default, this renders
all results in a JSON array. If a format is specified, the given template is executed for each result.
Example
Inspect the specified container and print its information in json format.
$ podman container inspect foobar
[
{
"Id": "99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6",
"Created": "2021-09-16T06:09:08.936623325-04:00",
"Path": "echo",
"Args": [
"hi"
],
"State": {
"OciVersion": "1.0.2-dev",
"Status": "exited",
"Running": false,
"Paused": false,
"Restarting": false,
"OOMKilled": false,
"Dead": false,
"Pid": 0,
"ExitCode": 0,
"Error": "",
"StartedAt": "2021-09-16T06:09:09.033564436-04:00",
"FinishedAt": "2021-09-16T06:09:09.036184314-04:00",
"Healthcheck": {
"Status": "",
"FailingStreak": 0,
"Log": null
}
},
"Image": "14119a10abf4669e8cdbdff324a9f9605d99697215a0d21c360fe8dfa8471bab",
"ImageName": "docker.io/library/alpine:latest",
"Rootfs": "",
"Pod": "",
"ResolvConfPath": "/run/user/3267/containers/overlay-containers/99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6/userdata/resolv.conf",
"HostnamePath": "/run/user/3267/containers/overlay-containers/99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6/userdata/hostname",
"HostsPath": "/run/user/3267/containers/overlay-containers/99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6/userdata/hosts",
"StaticDir": "/home/dwalsh/.local/share/containers/storage/overlay-containers/99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6/userdata",
"OCIConfigPath": "/home/dwalsh/.local/share/containers/storage/overlay-containers/99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6/userdata/config.json",
"OCIRuntime": "crun",
"ConmonPidFile": "/run/user/3267/containers/overlay-containers/99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6/userdata/conmon.pid",
"PidFile": "/run/user/3267/containers/overlay-containers/99f66530fe9c7249f7cf29f78e8661669d5831cbe4ee80ea757d5e922dd6a8a6/userdata/pidfile",
"Name": "foobar",
"RestartCount": 0,
"Driver": "overlay",
"MountLabel": "system_u:object_r:container_file_t:s0:c25,c695",
"ProcessLabel": "system_u:system_r:container_t:s0:c25,c695",
"AppArmorProfile": "",
"EffectiveCaps": [
"CAP_CHOWN",
"CAP_DAC_OVERRIDE",
"CAP_FOWNER",
"CAP_FSETID",
"CAP_KILL",
"CAP_NET_BIND_SERVICE",
"CAP_SETFCAP",
"CAP_SETGID",
"CAP_SETPCAP",
"CAP_SETUID",
],
"BoundingCaps": [
"CAP_CHOWN",
"CAP_DAC_OVERRIDE",
"CAP_FOWNER",
"CAP_FSETID",
"CAP_KILL",
"CAP_NET_BIND_SERVICE",
"CAP_SETFCAP",
"CAP_SETGID",
"CAP_SETPCAP",
"CAP_SETUID",
],
"ExecIDs": [],
"GraphDriver": {
"Name": "overlay",
"Data": {
"LowerDir": "/home/dwalsh/.local/share/containers/storage/overlay/e2eb06d8af8218cfec8210147357a68b7e13f7c485b991c288c2d01dc228bb68/diff",
"UpperDir": "/home/dwalsh/.local/share/containers/storage/overlay/8f3d70434a3db17410ec4710caf4f251f3e4ed0a96a08124e4b3d4af0a0ea300/diff",
"WorkDir": "/home/dwalsh/.local/share/containers/storage/overlay/8f3d70434a3db17410ec4710caf4f251f3e4ed0a96a08124e4b3d4af0a0ea300/work"
}
},
"Mounts": [],
"Dependencies": [],
"NetworkSettings": {
"EndpointID": "",
"Gateway": "",
"IPAddress": "",
"IPPrefixLen": 0,
"IPv6Gateway": "",
"GlobalIPv6Address": "",
"GlobalIPv6PrefixLen": 0,
"MacAddress": "",
"Bridge": "",
"SandboxID": "",
"HairpinMode": false,
"LinkLocalIPv6Address": "",
"LinkLocalIPv6PrefixLen": 0,
"Ports": {},
"SandboxKey": ""
},
"Namespace": "",
"IsInfra": false,
"Config": {
"Hostname": "99f66530fe9c",
"Domainname": "",
"User": "",
"AttachStdin": false,
"AttachStdout": false,
"AttachStderr": false,
"Tty": false,
"OpenStdin": false,
"StdinOnce": false,
"Env": [
"PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
"TERM=xterm",
"container=podman",
"HOME=/root",
"HOSTNAME=99f66530fe9c"
],
"Cmd": [
"echo",
"hi"
],
"Image": "docker.io/library/alpine:latest",
"Volumes": null,
"WorkingDir": "/",
"Entrypoint": "",
"OnBuild": null,
"Labels": null,
"Annotations": {
"io.container.manager": "libpod",
"io.kubernetes.cri-o.Created": "2021-09-16T06:09:08.936623325-04:00",
"org.opencontainers.image.stopSignal": "15"
},
"StopSignal": 15,
"CreateCommand": [
"podman",
"run",
"--name",
"foobar",
"alpine",
"echo",
"hi"
],
"Timezone": "local",
"Umask": "0022",
"Timeout": 0,
"StopTimeout": 10
},
"HostConfig": {
"Binds": [],
"CgroupManager": "systemd",
"CgroupMode": "private",
"ContainerIDFile": "",
"LogConfig": {
"Type": "journald",
"Config": null,
"Path": "",
"Tag": "",
"Size": "0B"
},
"NetworkMode": "slirp4netns",
"PortBindings": {},
"RestartPolicy": {
"Name": "",
"MaximumRetryCount": 0
},
"AutoRemove": false,
"VolumeDriver": "",
"VolumesFrom": null,
"CapAdd": [],
"CapDrop": [],
"Dns": [],
"DnsOptions": [],
"DnsSearch": [],
"ExtraHosts": [],
"GroupAdd": [],
"IpcMode": "shareable",
"Cgroup": "",
"Cgroups": "default",
"Links": null,
"OomScoreAdj": 0,
"PidMode": "private",
"Privileged": false,
"PublishAllPorts": false,
"ReadonlyRootfs": false,
"SecurityOpt": [],
"Tmpfs": {},
"UTSMode": "private",
"UsernsMode": "",
"ShmSize": 65536000,
"Runtime": "oci",
"ConsoleSize": [
0,
0
],
"Isolation": "",
"CpuShares": 0,
"Memory": 0,
"NanoCpus": 0,
"CgroupParent": "user.slice",
"BlkioWeight": 0,
"BlkioWeightDevice": null,
"BlkioDeviceReadBps": null,
"BlkioDeviceWriteBps": null,
"BlkioDeviceReadIOps": null,
"BlkioDeviceWriteIOps": null,
"CpuPeriod": 0,
"CpuQuota": 0,
"CpuRealtimePeriod": 0,
"CpuRealtimeRuntime": 0,
"CpusetCpus": "",
"CpusetMems": "",
"Devices": [],
"DiskQuota": 0,
"KernelMemory": 0,
"MemoryReservation": 0,
"MemorySwap": 0,
"MemorySwappiness": 0,
"OomKillDisable": false,
"PidsLimit": 2048,
"Ulimits": [],
"CpuCount": 0,
"CpuPercent": 0,
"IOMaximumIOps": 0,
"IOMaximumBandwidth": 0,
"CgroupConf": null
}
}
]
Inspect the specified container for the Image Name it is based on.
$ podman container inspect nervous_fermi --format "{{.ImageName}}"
registry.access.redhat.com/ubi8:latest
Inspect the specified container for the GraphDriver Name it is running with.
$ podman container inspect foobar --format "{{.GraphDriver.Name}}"
overlay
Inspect the latest container created for its EffectiveCaps field. (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_FOWNER CAP_FSETID CAP_KILL CAP_NET_BIND_SERVICE CAP_SETFCAP CAP_SETGID CAP_SETPCAP CAP_SETUID]
History
Sep 2021, Originally compiled by Dan Walsh dwalsh@redhat.com ⟨mailto:dwalsh@redhat.com⟩
podman-container-inspect(1)
Name
podman-container-inspect - Display a container's configuration
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).
Valid placeholders for the Go template are listed below:
┌──────────────────────────┬───────────────────────────────────────┐
│ Placeholder │ Description │
├──────────────────────────┼───────────────────────────────────────┤
│ .AppArmorProfile │ AppArmorprofile(string) │
├──────────────────────────┼───────────────────────────────────────┤
│ .Args │ Command-line arguments (array of │
│ │ strings) │
├──────────────────────────┼───────────────────────────────────────┤
│ .BoundingCaps │ Bounding capability set (array of │
│ │ strings) │
├──────────────────────────┼───────────────────────────────────────┤
│ .Config... │ Structurewithconfiginfo │
├──────────────────────────┼───────────────────────────────────────┤
│ .ConmonPidFile │ Path to file containing conmon pid │
│ │ (string) │
├──────────────────────────┼───────────────────────────────────────┤
│ .Created... │ Container creation time (string, │
│ │ ISO3601) │
├──────────────────────────┼───────────────────────────────────────┤
│ .Dependencies │ Dependencies (array of strings) │
├──────────────────────────┼───────────────────────────────────────┤
│ .Driver │ Storagedriver(string) │
├──────────────────────────┼───────────────────────────────────────┤
│ .EffectiveCaps │ Effective capability set (array of │
│ │ strings) │
├──────────────────────────┼───────────────────────────────────────┤
│ .ExecIDs │ ExecIDs(arrayofstrings) │
├──────────────────────────┼───────────────────────────────────────┤
│ .GraphDriver... │ Further details of graph driver │
│ │ (struct) │
├──────────────────────────┼───────────────────────────────────────┤
│ .HostConfig... │ Hostconfigdetails(struct) │
├──────────────────────────┼───────────────────────────────────────┤
│ .HostnamePath │ Path to file containing hostname │
│ │ (string) │
├──────────────────────────┼───────────────────────────────────────┤
│ .HostsPath │ Path to container /etc/hosts file │
│ │ (string) │
├──────────────────────────┼───────────────────────────────────────┤
│ .ID │ Container ID (full 64-char hash) │
├──────────────────────────┼───────────────────────────────────────┤
│ .Image │ Container image ID (64-char hash) │
├──────────────────────────┼───────────────────────────────────────┤
│ .ImageDigest │ Container image digest │
│ │ (sha256:+64-char hash) │
├──────────────────────────┼───────────────────────────────────────┤
│ .ImageName │ Containerimagename(string) │
├──────────────────────────┼───────────────────────────────────────┤
│ .IsInfra │ Is this an infra container? (string: │
│ │ true/false) │
├──────────────────────────┼───────────────────────────────────────┤
│ .IsService │ Is this a service container? (string: │
│ │ true/false) │
├──────────────────────────┼───────────────────────────────────────┤
│ .KubeExitCodePropagation │ Kube exit-code propagation (string) │
├──────────────────────────┼───────────────────────────────────────┤
│ .LockNumber │ Number of the container's Libpod lock │
├──────────────────────────┼───────────────────────────────────────┤
│ .MountLabel │ SELinux label of mount (string) │
├──────────────────────────┼───────────────────────────────────────┤
│ .Mounts │ Mounts(arrayofstrings) │
├──────────────────────────┼───────────────────────────────────────┤
│ .Name │ Containername(string) │
├──────────────────────────┼───────────────────────────────────────┤
│ .Namespace │ Containernamespace(string) │
├──────────────────────────┼───────────────────────────────────────┤
│ .NetworkSettings... │ Networksettings(struct) │
├──────────────────────────┼───────────────────────────────────────┤
│ .OCIConfigPath │ Path to OCI config file (string) │
├──────────────────────────┼───────────────────────────────────────┤
│ .OCIRuntime │ OCIruntimename(string) │
├──────────────────────────┼───────────────────────────────────────┤
│ .Path │ Path to container command (string) │
├──────────────────────────┼───────────────────────────────────────┤
│ .PidFile │ Path to file containing container PID │
│ │ (string) │
├──────────────────────────┼───────────────────────────────────────┤
│ .Pod │ Parentpod(string) │
├──────────────────────────┼───────────────────────────────────────┤
│ .ProcessLabel │ SELinux label of process (string) │
├──────────────────────────┼───────────────────────────────────────┤
│ .ResolvConfPath │ Path to container's resolv.conf file │
│ │ (string) │
├──────────────────────────┼───────────────────────────────────────┤
│ .RestartCount │ Number of times container has been │
│ │ restarted (int) │
├──────────────────────────┼───────────────────────────────────────┤
│ .Rootfs │ Containerrootfs(string) │
├──────────────────────────┼───────────────────────────────────────┤
│ .SizeRootFs │ Sizeofrootfs,inbytes[1] │
├──────────────────────────┼───────────────────────────────────────┤
│ .SizeRw │ Size of upper (R/W) container layer, │
│ │ in bytes [1] │
├──────────────────────────┼───────────────────────────────────────┤
│ .State... │ Containerstateinfo(struct) │
├──────────────────────────┼───────────────────────────────────────┤
│ .StaticDir │ Path to container metadata dir │
│ │ (string) │
├──────────────────────────┼───────────────────────────────────────┤
│ .UseImageHostname │ Use /etc/hostname from the image if │
│ │ it exists? (string: true/false) │
├──────────────────────────┼───────────────────────────────────────┤
│ │ │
├──────────────────────────┼───────────────────────────────────────┤
│ .UseImageHosts │ Use /etc/hosts from the image? │
│ │ (string: true/false) │
├──────────────────────────┼───────────────────────────────────────┤
│ │ │
└──────────────────────────┴───────────────────────────────────────┘
[1] This format specifier requires the --size option
--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. (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.
See Also
podman(1), podman-container(1), podman-inspect(1)
Synopsis
podmancontainerinspect [options] container [container ...]
PNG Icons
