DOCKER(1)		      Docker User Manuals		     DOCKER(1)



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: 'json':
       Print in JSON format 'TEMPLATE':		Print output using the given
       Go template.  Refer to https://docs.docker.com/go/formatting/ for more
       information about formatting output with templates


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


       --type=""      Only inspect objects of the given type



SEE ALSO
       docker(1)

Docker Community		   Sep 2025			     DOCKER(1)