Docker Engine 29 reference · Containers

docker inspect Command (Docker CLI)

Show the low-level JSON configuration and state of containers, images, volumes or networks; extract fields with --format.

Docker Engine 29

Create a free account to save this page, take notes and track your progress. Sign in

Syntax

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

Parameters

ParameterDescription
--format TEMPLATE Extract fields with a Go template.
--type TYPE Restrict to container, image, volume, network...

Examples

Pick fields from a container
docker run -d --name rc-ref-insp -e MODE=demo alpine:3.24 sleep 300 > /dev/null
docker inspect rc-ref-insp --format 'state={{.State.Status}} image={{.Config.Image}} restart={{.HostConfig.RestartPolicy.Name}}'
docker inspect rc-ref-insp --format '{{json .Config.Env}}'
docker rm -f rc-ref-insp > /dev/null

Output

state=running image=alpine:3.24 restart=no
["MODE=demo","PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"]

Run this on your computer — see “Get Started” for setup.

Inspect an image
docker inspect alpine:3.24 --format '{{.Os}}/{{.Architecture}} cmd={{json .Config.Cmd}}'

Output

linux/amd64 cmd=["/bin/sh"]

Run this on your computer — see “Get Started” for setup.

Was this page helpful?