From 83384ebc7778212871e12d2b5fd81f623a3088e6 Mon Sep 17 00:00:00 2001 From: David Karlsson <35727626+dvdksn@users.noreply.github.com> Date: Thu, 19 Mar 2026 17:03:40 +0100 Subject: [PATCH] docs: add docker builder prune to pruning page Fixes #17590. Adds a new "Prune build cache" section covering docker builder prune, including the --all flag for removing all build cache (not just dangling entries). Co-Authored-By: Claude Sonnet 4.6 --- .../engine/manage-resources/pruning.md | 26 ++++++++++++++++--- 1 file changed, 23 insertions(+), 3 deletions(-) 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,