podman-volume-prune
podman-volume-prune(1) General Commands Manual podman-volume-prune(1)
NAME
podman-volume-prune - Remove all unused volumesSYNOPSIS
podman volume prune [options]DESCRIPTION
Removes unused volumes. By default all unused volumes are removed, the --filter flag can be used to filter specific volumes. Users are prompted to confirm the removal of all the un‐
used volumes. To bypass the confirmation, use the --force flag.OPTIONS --filter
Provide filter values.
The filters argument format is of key=value. If there is more than one filter, then pass multiple OPTIONS: --filter foo=bar --filter bif=baz.
Supported filters:
┌─────────────┬─────────────────────────────────────────────────────────────────┐
│ Filter │ Description │
├─────────────┼─────────────────────────────────────────────────────────────────┤
│ dangling │ [Bool] Only remove volumes not referenced by any containers │
├─────────────┼─────────────────────────────────────────────────────────────────┤
│ driver │ [String] Only remove volumes with the given driver │
├─────────────┼─────────────────────────────────────────────────────────────────┤
│ label │ [String] Only remove volumes, with (or without, in the case of │
│ │ label!=[...] is used) the specified labels. │
├─────────────┼─────────────────────────────────────────────────────────────────┤
│ name │ [String] Only remove volume with the given name │
├─────────────┼─────────────────────────────────────────────────────────────────┤
│ opt │ [String] Only remove volumes created with the given options │
├─────────────┼─────────────────────────────────────────────────────────────────┤
│ scope │ [String] Only remove volumes with the given scope │
├─────────────┼─────────────────────────────────────────────────────────────────┤
│ until │ [DateTime] Only remove volumes created before given timestamp. │
├─────────────┼─────────────────────────────────────────────────────────────────┤
│ after/since │ [Volume] Filter by volumes created after the given VOLUME (name │
│ │ or tag) │
└─────────────┴─────────────────────────────────────────────────────────────────┘
The label filter accepts two formats. One is the label=key or label=key=value, which removes volumes with the specified labels. The other format is the label!=key or label!=key=value,
which removes volumes without the specified labels.
The until filter can be Unix timestamps, date formatted timestamps, or Go duration strings (e.g. 10m, 1h30m) computed relative to the machine’s time.--force, -f
Do not prompt for confirmation.--help
Print usage statementEXAMPLES
Prune all unused volumes.
$ podman volume prune
Prune all volumes. Note: this command will also remove all containers that are using a volume.
$ podman volume prune --force
Prune all volumes that contain the specified label.
$ podman volume prune --filter label=mylabel=mylabelvalueSEE ALSO
podman(1), podman-volume(1)HISTORY
November 2018, Originally compiled by Urvashi Mohnani umohnani@redhat.com ⟨mailto:umohnani@redhat.com⟩
podman-volume-prune(1)