diff --git a/content/manuals/engine/manage-resources/pruning.md b/content/manuals/engine/manage-resources/pruning.md index 630db86d3223..9c6861d1bece 100644 --- a/content/manuals/engine/manage-resources/pruning.md +++ b/content/manuals/engine/manage-resources/pruning.md @@ -1,11 +1,12 @@ --- description: Free up disk space by removing unused resources with the prune command -keywords: pruning, prune, images, volumes, containers, networks, disk, administration, +keywords: + pruning, prune, images, volumes, containers, networks, disk, administration, garbage collection title: Prune unused Docker objects aliases: -- /engine/admin/pruning/ -- /config/pruning/ + - /engine/admin/pruning/ + - /config/pruning/ --- Docker takes a conservative approach to cleaning up unused objects (often @@ -143,6 +144,25 @@ Other filtering expressions are available. See the [`docker network prune` reference](/reference/cli/docker/network/prune/) for more examples. +## Prune build cache + +`docker buildx prune` removes the build cache for the currently selected +builder. If you use multiple builders, each builder maintains its own cache — +use the `--builder` flag to target a specific builder instance. + +```console +$ docker buildx prune + +WARNING! This will remove all dangling build cache. +Are you sure you want to continue? [y/N] y +``` + +By default, you're prompted to continue. To bypass the prompt, use the `-f` or +`--force` flag. + +See the [`docker buildx prune` reference](/reference/cli/docker/buildx/prune/) +for all options, including `--all` to also remove internal and frontend images. + ## Prune everything The `docker system prune` command is a shortcut that prunes images, containers,