containers-storage-delete-image(1)

containers-storage-delete-image1

Delete an image

Usage

containers-storage delete-image imageNameOrID

Overview

Deletes an image if it is not currently being used by any containers. If the image's top layer is not being used by any other images, it will be removed. If that image's parent is then not being used by other images, it, too, will be removed, and this will be repeated for each parent's parent.

Examples

containers-storage delete-image my-base-image

Releases

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

  1. 11
  2. 12–13
  3. Arch

From containers-common 1:0.69.2-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.