NAME

       docker-inspect - Return low-level information on Docker objects

SYNOPSIS

       docker inspect [OPTIONS] NAME|ID [NAME|ID...]

DESCRIPTION

       This  displays  the  low-level  information  on  Docker  object(s) (e.g. container, image,
       volume,network, node, service, or task) 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.

EXAMPLES

       Get  information  about  an  image when image name conflicts with the container name, e.g.
       both image and container are named rhel7:

       $ docker inspect --type=image rhel7
       [
       {
        "Id": "fe01a428b9d9de35d29531e9994157978e8c48fa693e1bf1d221dffbbb67b170",
        "Parent": "10acc31def5d6f249b548e01e8ffbaccfd61af0240c17315a7ad393d022c5ca2",
        ....
       }
       ]

Getting information on a container

       To get information on a container use its ID or instance name:

       $ docker inspect d2cc496561d6
       [{
       "Id": "d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47",
       "Created": "2015-06-08T16:18:02.505155285Z",
       "Path": "bash",
       "Args": [],
       "State": {
           "Running": false,
           "Paused": false,
           "Restarting": false,
           "OOMKilled": false,
           "Dead": false,
           "Pid": 0,
           "ExitCode": 0,
           "Error": "",
           "StartedAt": "2015-06-08T16:18:03.643865954Z",
           "FinishedAt": "2015-06-08T16:57:06.448552862Z"
       },
       "Image": "ded7cd95e059788f2586a51c275a4f151653779d6a7f4dad77c2bd34601d94e4",
       "NetworkSettings": {
           "Bridge": "",
           "SandboxID": "6b4851d1903e16dd6a567bd526553a86664361f31036eaaa2f8454d6f4611f6f",
           "HairpinMode": false,
           "LinkLocalIPv6Address": "",
           "LinkLocalIPv6PrefixLen": 0,
           "Ports": {},
           "SandboxKey": "/var/run/docker/netns/6b4851d1903e",
           "SecondaryIPAddresses": null,
           "SecondaryIPv6Addresses": null,
           "EndpointID": "7587b82f0dada3656fda26588aee72630c6fab1536d36e394b2bfbcf898c971d",
           "Gateway": "172.17.0.1",
           "GlobalIPv6Address": "",
           "GlobalIPv6PrefixLen": 0,
           "IPAddress": "172.17.0.2",
           "IPPrefixLen": 16,
           "IPv6Gateway": "",
           "MacAddress": "02:42:ac:12:00:02",
           "Networks": {
               "bridge": {
                   "NetworkID": "7ea29fc1412292a2d7bba362f9253545fecdfa8ce9a6e37dd10ba8bee7129812",
                   "EndpointID": "7587b82f0dada3656fda26588aee72630c6fab1536d36e394b2bfbcf898c971d",
                   "Gateway": "172.17.0.1",
                   "IPAddress": "172.17.0.2",
                   "IPPrefixLen": 16,
                   "IPv6Gateway": "",
                   "GlobalIPv6Address": "",
                   "GlobalIPv6PrefixLen": 0,
                   "MacAddress": "02:42:ac:12:00:02"
               }
           }

       },
       "ResolvConfPath": "/var/lib/docker/containers/d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47/resolv.conf",
       "HostnamePath": "/var/lib/docker/containers/d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47/hostname",
       "HostsPath": "/var/lib/docker/containers/d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47/hosts",
       "LogPath": "/var/lib/docker/containers/d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47/d2cc496561d6d520cbc0236b4ba88c362c446a7619992123f11c809cded25b47-json.log",
       "Name": "/adoring_wozniak",
       "RestartCount": 0,
       "Driver": "overlay2",
       "MountLabel": "",
       "ProcessLabel": "",
       "Mounts": [
         {
           "Source": "/data",
           "Destination": "/data",
           "Mode": "ro,Z",
           "RW": false
           "Propagation": ""
         }
       ],
       "AppArmorProfile": "",
       "ExecIDs": null,
       "HostConfig": {
           "Binds": null,
           "ContainerIDFile": "",
           "Memory": 0,
           "MemorySwap": 0,
           "CpuShares": 0,
           "CpuPeriod": 0,
           "CpusetCpus": "",
           "CpusetMems": "",
           "CpuQuota": 0,
           "BlkioWeight": 0,
           "OomKillDisable": false,
           "Privileged": false,
           "PortBindings": {},
           "Links": null,
           "PublishAllPorts": false,
           "Dns": null,
           "DnsSearch": null,
           "DnsOptions": null,
           "ExtraHosts": null,
           "VolumesFrom": null,
           "Devices": [],
           "NetworkMode": "bridge",
           "IpcMode": "",
           "PidMode": "",
           "UTSMode": "",
           "CapAdd": null,
           "CapDrop": null,
           "RestartPolicy": {
               "Name": "no",
               "MaximumRetryCount": 0
           },
           "SecurityOpt": null,
           "ReadonlyRootfs": false,
           "Ulimits": null,
           "LogConfig": {
               "Type": "json-file",
               "Config": {}
           },
           "CgroupParent": ""
       },
       "GraphDriver": {
           "Data": {
               "LowerDir": "/var/lib/docker/overlay2/44b1d1f04db6b1b73a86f9a62678673bf5d16d9a6b62c13e859aa34a99cce5ea/diff:/var/lib/docker/overlay2/ef637181eb13e30e84b7382183364ed7fd7ff7be22d8bb87049e36b75fb89a86/diff:/var/lib/docker/overlay2/64fb0f850b1289cd09cbc3b077cab2c0f59a4f540c67f997b094fc3652b9b0d6/diff:/var/lib/docker/overlay2/68c4d1411addc2b2bd07e900ca3a059c9c5f9fa2607efd87d8d715a0080ed242/diff",
               "MergedDir": "/var/lib/docker/overlay2/c7846fe68c6f18247ab9b8672114dde9f506bc164081a895c465716eeb10f2bc/merged",
               "UpperDir": "/var/lib/docker/overlay2/c7846fe68c6f18247ab9b8672114dde9f506bc164081a895c465716eeb10f2bc/diff",
               "WorkDir": "/var/lib/docker/overlay2/c7846fe68c6f18247ab9b8672114dde9f506bc164081a895c465716eeb10f2bc/work"
           },
           "Name": "overlay2"
       },
       "Config": {
           "Hostname": "d2cc496561d6",
           "Domainname": "",
           "User": "",
           "AttachStdin": true,
           "AttachStdout": true,
           "AttachStderr": true,
           "ExposedPorts": null,
           "Tty": true,
           "OpenStdin": true,
           "StdinOnce": true,
           "Env": null,
           "Cmd": [
               "bash"
           ],
           "Image": "fedora",
           "Volumes": null,
           "VolumeDriver": "",
           "WorkingDir": "",
           "Entrypoint": null,
           "NetworkDisabled": false,
           "MacAddress": "",
           "OnBuild": null,
           "Labels": {},
           "Memory": 0,
           "MemorySwap": 0,
           "CpuShares": 0,
           "Cpuset": "",
           "StopSignal": "SIGTERM"
       }
       }
       ]

Getting the IP address of a container instance

       To get the IP address of a container use:

       $ docker inspect --format='{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' d2cc496561d6
       172.17.0.2

Listing all port bindings

       One can loop over arrays and maps in the results to produce simple text output:

       $ docker inspect --format='{{range $p, $conf := .NetworkSettings.Ports}} \
         {{$p}} -> {{(index $conf 0).HostPort}} {{end}}' d2cc496561d6
         80/tcp -> 80

       You  can   get   more   information   about   how   to   write   a   Go   template   from:
       https://pkg.go.dev/text/template.

Getting size information on a container

       $ docker inspect -s d2cc496561d6
       [
       {
       "SizeRw": 0,
       "SizeRootFs": 972,
       }
       ]

Getting information on an image

       Use  an  image's  ID  or  name  (e.g., repository/name[:tag]) to get information about the
       image:

       $ docker inspect ded7cd95e059
       [{
       "Id": "ded7cd95e059788f2586a51c275a4f151653779d6a7f4dad77c2bd34601d94e4",
       "Parent": "48ecf305d2cf7046c1f5f8fcbcd4994403173441d4a7f125b1bb0ceead9de731",
       "Comment": "",
       "Created": "2015-05-27T16:58:22.937503085Z",
       "Container": "76cf7f67d83a7a047454b33007d03e32a8f474ad332c3a03c94537edd22b312b",
       "ContainerConfig": {
           "Hostname": "76cf7f67d83a",
           "Domainname": "",
           "User": "",
           "AttachStdin": false,
           "AttachStdout": false,
           "AttachStderr": false,
           "ExposedPorts": null,
           "Tty": false,
           "OpenStdin": false,
           "StdinOnce": false,
           "Env": null,
           "Cmd": [
               "/bin/sh",
               "-c",
               "#(nop) ADD file:4be46382bcf2b095fcb9fe8334206b584eff60bb3fad8178cbd97697fcb2ea83 in /"
           ],
           "Image": "48ecf305d2cf7046c1f5f8fcbcd4994403173441d4a7f125b1bb0ceead9de731",
           "Volumes": null,
           "VolumeDriver": "",
           "WorkingDir": "",
           "Entrypoint": null,
           "NetworkDisabled": false,
           "MacAddress": "",
           "OnBuild": null,
           "Labels": {}
       },
       "DockerVersion": "1.6.0",
       "Author": "Lokesh Mandvekar \u003clsm5@fedoraproject.org\u003e",
       "Config": {
           "Hostname": "76cf7f67d83a",
           "Domainname": "",
           "User": "",
           "AttachStdin": false,
           "AttachStdout": false,
           "AttachStderr": false,
           "ExposedPorts": null,
           "Tty": false,
           "OpenStdin": false,
           "StdinOnce": false,
           "Env": null,
           "Cmd": null,
           "Image": "48ecf305d2cf7046c1f5f8fcbcd4994403173441d4a7f125b1bb0ceead9de731",
           "Volumes": null,
           "VolumeDriver": "",
           "WorkingDir": "",
           "Entrypoint": null,
           "NetworkDisabled": false,
           "MacAddress": "",
           "OnBuild": null,
           "Labels": {}
       },
       "Architecture": "amd64",
       "Os": "linux",
       "Size": 186507296,
       "VirtualSize": 186507296,
       "GraphDriver": {
           "Data": {
               "LowerDir": "/var/lib/docker/overlay2/44b1d1f04db6b1b73a86f9a62678673bf5d16d9a6b62c13e859aa34a99cce5ea/diff:/var/lib/docker/overlay2/ef637181eb13e30e84b7382183364ed7fd7ff7be22d8bb87049e36b75fb89a86/diff:/var/lib/docker/overlay2/64fb0f850b1289cd09cbc3b077cab2c0f59a4f540c67f997b094fc3652b9b0d6/diff:/var/lib/docker/overlay2/68c4d1411addc2b2bd07e900ca3a059c9c5f9fa2607efd87d8d715a0080ed242/diff",
               "MergedDir": "/var/lib/docker/overlay2/c7846fe68c6f18247ab9b8672114dde9f506bc164081a895c465716eeb10f2bc/merged",
               "UpperDir": "/var/lib/docker/overlay2/c7846fe68c6f18247ab9b8672114dde9f506bc164081a895c465716eeb10f2bc/diff",
               "WorkDir": "/var/lib/docker/overlay2/c7846fe68c6f18247ab9b8672114dde9f506bc164081a895c465716eeb10f2bc/work"
           },
           "Name": "overlay2"
       }
       }]

OPTIONS

       -f,   --format=""        Format   output   using   a    custom    template:    Refer    to
       https://docs.docker.com/go/formatting/  for  more information about formatting output with
       templates

       -h, --help[=false]      help for inspect

       -s, --size[=false]      Display total file sizes if the type is container

       --type=""      Return JSON for specified type

SEE ALSO

       docker(1)