Provided by: podman_4.3.1+ds1-5ubuntu1_amd64 
NAME
podman-container-inspect - Display a container's configuration
SYNOPSIS
podman container inspect [options] container [container ...]
DESCRIPTION
This displays the low-level information on containers identified by name or ID. By
default, this will render all results in a JSON array. If a format is specified, the given
template will be executed for each result.
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 │ AppArmor profile (string) │
├─────────────────────┼──────────────────────────────────┤
│.Args │ Command-line arguments (array of │
│ │ strings) │
├─────────────────────┼──────────────────────────────────┤
│.BoundingCaps │ Bounding capability set (array │
│ │ of strings) │
├─────────────────────┼──────────────────────────────────┤
│.Config ... │ Structure with config info │
├─────────────────────┼──────────────────────────────────┤
│.ConmonPidFile │ Path to file containing conmon │
│ │ pid (string) │
├─────────────────────┼──────────────────────────────────┤
│.Created │ Container creation time (string, │
│ │ ISO3601) │
├─────────────────────┼──────────────────────────────────┤
│.Dependencies │ Dependencies (array of strings) │
├─────────────────────┼──────────────────────────────────┤
│.Driver │ Storage driver (string) │
├─────────────────────┼──────────────────────────────────┤
│.EffectiveCaps │ Effective capability set (array │
│ │ of strings) │
├─────────────────────┼──────────────────────────────────┤
│.ExecIDs │ Exec IDs (array of strings) │
├─────────────────────┼──────────────────────────────────┤
│.GraphDriver ... │ Further details of graph driver │
│ │ (struct) │
├─────────────────────┼──────────────────────────────────┤
│.HostConfig ... │ Host config details (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) │
├─────────────────────┼──────────────────────────────────┤
│.ImageName │ Container image name (string) │
├─────────────────────┼──────────────────────────────────┤
│.IsInfra │ Is this an infra container? │
│ │ (string: true/false) │
├─────────────────────┼──────────────────────────────────┤
│.IsService │ Is this a service container? │
│ │ (string: true/false) │
├─────────────────────┼──────────────────────────────────┤
│.MountLabel │ SELinux label of mount (string) │
├─────────────────────┼──────────────────────────────────┤
│.Mounts │ Mounts (array of strings) │
├─────────────────────┼──────────────────────────────────┤
│.Name │ Container name (string) │
├─────────────────────┼──────────────────────────────────┤
│.Namespace │ Container namespace (string) │
├─────────────────────┼──────────────────────────────────┤
│.NetworkSettings ... │ Network settings (struct) │
├─────────────────────┼──────────────────────────────────┤
│.OCIConfigPath │ Path to OCI config file (string) │
├─────────────────────┼──────────────────────────────────┤
│.OCIRuntime │ OCI runtime name (string) │
├─────────────────────┼──────────────────────────────────┤
│.Path │ Path to container command │
│ │ (string) │
├─────────────────────┼──────────────────────────────────┤
│.PidFile │ Path to file containing │
│ │ container PID (string) │
├─────────────────────┼──────────────────────────────────┤
│.Pod │ Parent pod (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 │ Container rootfs (string) │
├─────────────────────┼──────────────────────────────────┤
│.SizeRootFs │ Size of rootfs, in bytes [1] │
├─────────────────────┼──────────────────────────────────┤
│.SizeRw │ Size of upper (R/W) container │
│ │ layer, in bytes [1] │
├─────────────────────┼──────────────────────────────────┤
│.State ... │ Container state info (struct) │
├─────────────────────┼──────────────────────────────────┤
│.StaticDir │ Path to container metadata dir │
│ │ (string) │
└─────────────────────┴──────────────────────────────────┘
[1] This format specifier requires the --size option
--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.
(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.
EXAMPLE
$ 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",
"CAP_SYS_CHROOT"
],
"BoundingCaps": [
"CAP_CHOWN",
"CAP_DAC_OVERRIDE",
"CAP_FOWNER",
"CAP_FSETID",
"CAP_KILL",
"CAP_NET_BIND_SERVICE",
"CAP_SETFCAP",
"CAP_SETGID",
"CAP_SETPCAP",
"CAP_SETUID",
"CAP_SYS_CHROOT"
],
"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",
"io.kubernetes.cri-o.TTY": "false",
"io.podman.annotations.autoremove": "FALSE",
"io.podman.annotations.init": "FALSE",
"io.podman.annotations.privileged": "FALSE",
"io.podman.annotations.publish-all": "FALSE",
"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": [
"CAP_AUDIT_WRITE",
"CAP_MKNOD",
"CAP_NET_RAW"
],
"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
}
}
]
$ podman container inspect nervous_fermi --format "{{.ImageName}}"
registry.access.redhat.com/ubi8:latest
$ podman container inspect foobar --format "{{.GraphDriver.Name}}"
overlay
$ 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 CAP_SYS_CHROOT]
SEE ALSO
podman(1), podman-container(1), podman-inspect(1)
HISTORY
Sep 2021, Originally compiled by Dan Walsh dwalsh@redhat.com ⟨mailto:dwalsh@redhat.com⟩
podman-container-inspect(1)