Skip to content

System Prune Docs Misleading About Named Volume Removal #6118

Open
@davidmbrister

Description

@davidmbrister

Page: https://docs.docker.com/reference/cli/docker/system/prune/

Issue:

The documentation currently states:

“Prune volumes — only anonymous volumes are removed.”

However, this is inaccurate. In practice, docker system prune --volumes removes any dangling volume, whether anonymous or named, as long as it is not referenced by any container.

This behavior is clearly demonstrated in the example directly below this statement, where a named volume (named-vol) is created and later deleted via docker system prune --volumes.

Suggested correction:

“Prune volumes — only dangling volumes (volumes not currently used by any container) are removed. This includes both anonymous and named volumes.”

This change would clarify the actual behavior and prevent confusion for users relying on named volumes for persistence.

Thank you!

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions