docker buildx prune
| Description | Remove build cache |
|---|---|
| Usage | 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.24hor2h30m, with allowable units of(h)ours,(m)inutesand(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
--allflag to allow clearing internal helper images and frontend images set using the#syntax=directive or theBUILDKIT_SYNTAXbuild argument.
Options
| Option | Default | Description |
|---|---|---|
-a, --all
|
Include internal/frontend images | |
--filter
|
Provide filter values (e.g., until=24h)
|
|
-f, --force
|
Do not prompt for confirmation | |
--max-used-space
|
Maximum amount of disk space allowed to keep for cache | |
--min-free-space
|
Target amount of free disk space after pruning | |
--reserved-space
|
Amount of disk space always allowed to keep for cache | |
--verbose
|
Provide a more verbose output |
Examples
Override the configured builder instance (--builder)
Same as
buildx --builder.