docker inspect · Knowledge & Memory Center

Inspect anything

SHELL

1docker inspect <container|image|volume|network>

2docker container inspect <container>

3docker image inspect <image>

--format (or -f) takes a Go template, so you can pull out one value instead of scrolling JSON.

Examples

SHELL

1# IP address on its network(s)

2docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' <c>

3

4# Exit code and why it stopped

5docker inspect -f '{{.State.ExitCode}} {{.State.Error}} OOM={{.State.OOMKilled}}' <c>

6

7# Health status

8docker inspect -f '{{.State.Health.Status}}' <c>

9

10# Environment variables

11docker inspect -f '{{range .Config.Env}}{{println .}}{{end}}' <c>

12

13# Mounts as pretty JSON

14docker inspect -f '{{json .Mounts}}' <c> | jq

15

16# Where a volume lives on the host

17docker volume inspect -f '{{.Mountpoint}}' <volume>

Pipe to jq for readable output: docker inspect <c> | jq ".[0].State". OOMKilled: true with exit code 137 means the container ran out of memory.

!

inspect shows environment variables in plain text, including any secrets passed with -e.