From a127c372c2f85f8fc0d9c842831cdbb4d549e609 Mon Sep 17 00:00:00 2001 From: Santhi Prakash Date: Thu, 13 Aug 2026 12:54:45 +0000 Subject: [PATCH] docs: system prune --volumes removes anonymous volumes only - Problem: the pruning guide said docker system prune --volumes removes all unused volumes, and the example warning still said "all volumes" / "all build cache". - Fix: match Docker 29.1.3 CLI help and confirmation text: --volumes prunes unused anonymous volumes; named volumes need docker volume prune --all. - Verification: compared live `docker system prune --help` and the `docker system prune --volumes` warning (answered n) on 29.1.3. --- content/manuals/engine/manage-resources/pruning.md | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/content/manuals/engine/manage-resources/pruning.md b/content/manuals/engine/manage-resources/pruning.md index f3e4ab19d45..17e892811d9 100644 --- a/content/manuals/engine/manage-resources/pruning.md +++ b/content/manuals/engine/manage-resources/pruning.md @@ -168,8 +168,9 @@ 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, -and networks. Volumes aren't pruned by default, and you must specify the -`--volumes` flag for `docker system prune` to prune volumes. +and networks. Volumes aren't pruned by default. Add `--volumes` to also remove +unused **anonymous** volumes. Named unused volumes are left alone; use +`docker volume prune --all` if you intend to delete those too. ```console $ docker system prune @@ -183,7 +184,7 @@ WARNING! This will remove: Are you sure you want to continue? [y/N] y ``` -To also prune volumes, add the `--volumes` flag: +To also prune unused anonymous volumes, add the `--volumes` flag: ```console $ docker system prune --volumes @@ -191,9 +192,9 @@ $ docker system prune --volumes WARNING! This will remove: - all stopped containers - all networks not used by at least one container - - all volumes not used by at least one container + - all anonymous volumes not used by at least one container - all dangling images - - all build cache + - unused build cache Are you sure you want to continue? [y/N] y ```