podman-image-diff(1)

podman-image-diff1

Inspect changes on an image's filesystem

Usage

podman image diff [options] image [image]

Overview

Displays changes on an image's filesystem. The image is compared to its parent layer or the second argument when given.

The output is prefixed with the following symbols:

SymbolDescription
AA file or directory was added.
DA file or directory was deleted.
CA file or directory was changed.

Options

--format

Alter the output into a different format. The only valid format for podman image diff is json.

Examples

Display image differences from images parent layer:

$ podman image diff redis:old
C /usr
C /usr/local
C /usr/local/bin
A /usr/local/bin/docker-entrypoint.sh

Display image differences between two different images in JSON format:

$ podman image diff --format json redis:old redis:alpine
{
  "changed": [
    "/usr",
    "/usr/local",
    "/usr/local/bin"
  ],
  "added": [
    "/usr/local/bin/docker-entrypoint.sh"
  ]
}

Releases

4 releases since Debian 11 (Bullseye); the text changed 3 times.

  1. 11
  2. 12
  3. 13
  4. Arch

History

August 2017, Originally compiled by Ryan Cole [email protected] ⟨mailto:[email protected]⟩

From podman 6.1.4-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.