podman-image-prune(1)

NAME

podman-image-prune - Remove all unused images from the local store

SYNOPSIS

podman image prune [options]

DESCRIPTION

podman image prune removes all dangling images from local storage. With the all option, you can delete all unused images (i.e., images not in use by any container).

The image prune command does not prune cache images that only use layers that are necessary for other images.

OPTIONS

  --all, -a

Remove dangling images and images that have no associated containers.

  --filter=filters

Provide filter values.

The --filter flag format is of “key=value”. If there is more than one filter, then pass multiple flags (e.g., --filter "foo=bar" --filter "bif=baz")

Supported filters:

    •   until (timestamp) - only remove containers and images created before given timestamp

    •   label (label=key, label=key=value, label!=key, or label!=key=value) - only remove containers and images, with (or without, in case label!=... is used) the specified labels.

The until filter can be Unix timestamps, date formatted timestamps, or Go duration strings (e.g. 10m, 1h30m) computed relative to the machine’s time.

The label filter accepts two formats. One is the label=... (label=key or label=key=value), which removes images with the specified labels. The other format is the label!=... (label!=key or label!=key=value), which removes images without the specified labels.

  --force, -f

Do not provide an interactive prompt for container removal.

  --help, -h

Print usage statement

EXAMPLES

Remove all dangling images from local storage

    $ sudo podman image prune
    WARNING! This will remove all dangling images.
    Are you sure you want to continue? [y/N] y
    f3e20dc537fb04cb51672a5cb6fdf2292e61d411315549391a0d1f64e4e3097e
    324a7a3b2e0135f4226ffdd473e4099fd9e477a74230cdc35de69e84c0f9d907

Remove all unused images from local storage without confirming

    $ sudo podman image prune -a -f
    f3e20dc537fb04cb51672a5cb6fdf2292e61d411315549391a0d1f64e4e3097e
    324a7a3b2e0135f4226ffdd473e4099fd9e477a74230cdc35de69e84c0f9d907
    6125002719feb1ddf3030acab1df6156da7ce0e78e571e9b6e9c250424d6220c
    91e732da5657264c6f4641b8d0c4001c218ae6c1adb9dcef33ad00cafd37d8b6
    e4e5109420323221f170627c138817770fb64832da7d8fe2babd863148287fca
    77a57fa8285e9656dbb7b23d9efa837a106957409ddd702f995605af27a45ebe

Remove all unused images from local storage since given time/hours.

    $ sudo podman image prune -a --filter until=2019-11-14T06:15:42.937792374Z
    WARNING! This will remove all dangling images.
    Are you sure you want to continue? [y/N] y
    $ sudo podman image prune -f --filter until=10h
    f3e20dc537fb04cb51672a5cb6fdf2292e61d411315549391a0d1f64e4e3097e
    324a7a3b2e0135f4226ffdd473e4099fd9e477a74230cdc35de69e84c0f9d907

Remove all unused images from local storage with label version 1.0

    $ sudo podman image prune -a -f --filter label=version=1.0

SEE ALSO

podman(1), podman-images

HISTORY

December 2018, Originally compiled by Brent Baude (bbaude at redhat dot com) December 2020, converted filter information from docs.docker.com documentation by Dan Walsh (dwalsh at redhat dot com)