NAME¶

docker-buildx-prune - Remove build cache

SYNOPSIS¶

docker buildx prune

DESCRIPTION¶

Clears the build cache of the selected builder.

You can finely control what cache data is kept using:

•

The --filter=until=<duration> flag to keep images that have been used in the last <duration> time.

<duration> is a duration string, e.g. 24h or 2h30m, with allowable
units of (h)ours, (m)inutes and (s)econds.

•

The --keep-storage=<size> flag to keep <size> bytes of data in the cache.

<size> is a human-readable memory string, e.g. 128mb, 2gb, etc. Units
are case-insensitive.

•

The --all flag to allow clearing internal helper images and frontend images set using the #syntax= directive or the BUILDKIT_SYNTAX build argument.

OPTIONS¶

-a, --all[=false] Include internal/frontend images

--filter= Provide filter values (e.g., "until=24h")

-f, --force[=false] Do not prompt for confirmation

-h, --help[=false] help for prune

--max-used-space=0 Maximum amount of disk space allowed to keep for cache

--min-free-space=0 Target amount of free disk space after pruning

--reserved-space=0 Amount of disk space always allowed to keep for cache

--verbose[=false] Provide a more verbose output

OPTIONS INHERITED FROM PARENT COMMANDS¶

--builder="" Override the configured builder instance

-D, --debug[=false] Enable debug logging

EXAMPLE¶

### Override the configured builder instance (--builder) {#builder}
Same as [`buildx --builder`](/reference/cli/docker/buildx/#builder).

SEE ALSO¶

docker-buildx(1)