**`docker inspect`** is a command that returns detailed, low-level information on Docker objects. Those objects can be docker images, containers, networks, volumes, plugins, etc.

# Syntax

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

- OPTIONS
  - **`--format`**: Format the output using the given Go template
  - **`--size`**: Display total file sizes if the type is container
  - **`--type`**: Return JSON for specified type

> By default, `docker inspect` returns information in JSON format.

# Examples

1. Get an instance’s IP address:
```shell
docker inspect --format='{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' $INSTANCE_NAME
```

2. Get multiple instances' image name:
```shell
docker inspect --format='{{.Config.Image}}' $INSTANCE1_ID $INSTANCE2_ID
```

3. List all port bindings:
```shell
docker inspect --format='{{range $p, $conf := .NetworkSettings.Ports}} {{$p}} -> {{(index $conf 0).HostPort}} {{end}}' $INSTANCE_NAME
```

What is Docker inspect?

docker inspect provides detailed, low-level information on Docker objects, formatting options include --format, --size, and --type. Output is in JSON by default.