Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/apple/container/llms.txt

Use this file to discover all available pages before exploring further.

Removes unused images to reclaim disk space. By default, only removes dangling images (images with no tags). Use -a to remove all images not referenced by any container.

​
Usage

container image prune [--all] [--debug]

​
Options

​
-a, --all
boolean
Remove all unused images, not just dangling ones
​
--debug
boolean
Enable debug output

​
Examples

# Remove dangling images only
container image prune

# Remove all unused images
container image prune --all

​
Behavior

Without --all:
  • Only removes dangling images (untagged images)
  • Preserves all tagged images
With --all:
  • Removes all images not referenced by any container (running or stopped)
  • Includes both tagged and untagged images
Images removed with --all cannot be recovered. Ensure you don’t need them before pruning.
Run this command regularly to keep your image cache clean and free up disk space.

Build docs developers (and LLMs) love

Get started for freeTalk to us