dive

Analyze a Docker image

$ dive [image:tag]

$ dive [image:tag] --ci

$ dive build -t [image:tag] [.]

$ dive --source [docker-archive] [image.tar]

$ dive [image:tag] --ci --highestUserWastedPercent [0.1]

dive [options] image

dive is a tool for exploring Docker image contents and layer efficiency. It provides an interactive TUI showing what changed in each layer, helping identify opportunities to reduce image size.
The tool displays a layer-by-layer breakdown of the image filesystem, highlighting added, removed, and modified files. The efficiency score indicates how well the image is optimized, with wasted space shown explicitly.
dive integrates into CI pipelines to enforce image efficiency requirements. It can analyze images from Docker, Podman, or archive files, and can build images before analysis.

IMAGE

Docker image name with optional tag.

CI mode (no TUI, returns exit code).

Image source: docker, podman, docker-archive.

Build image then analyze.

Max wasted space percentage for CI pass.

Minimum efficiency for CI pass.

Output results as JSON.

Display help information.

Large images may take time to analyze. Some layer details depend on image build history. Squashed images have limited layer information. Requires container runtime access for live images.

dive was created by Alex Goodman and released in 2018. It was developed to address the common problem of Docker image bloat by making layer contents visible and quantifying efficiency.

docker(1), podman(1), skopeo(1)