buildx/docs/reference/buildx_prune.md
Tonis Tiigi 7a7a9c8e01
commands: add debug as persistent flag
Allows using `--debug` to enable debug logging under
any subcommand. Currently it needed to be set as
`docker --debug buildx` meaning only way to enable debug
in standalone mode was to set env variable instead and
updating existing commands to add `--debug` was cumbersome.

Signed-off-by: Tonis Tiigi <tonistiigi@gmail.com>
2024-08-16 13:20:28 +03:00

1.8 KiB

buildx prune

docker buildx prune

Remove build cache

Options

Name Type Default Description
-a, --all bool Include internal/frontend images
--builder string Override the configured builder instance
-D, --debug bool Enable debug logging
--filter filter Provide filter values (e.g., until=24h)
-f, --force bool Do not prompt for confirmation
--keep-storage bytes 0 Amount of disk space to keep for cache
--verbose bool Provide a more verbose output

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.

Examples

Override the configured builder instance (--builder)

Same as buildx --builder.