NAME

       podman-volume-prune - Remove all unused volumes

SYNOPSIS

       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 unused 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 statement

EXAMPLES

       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=mylabelvalue

SEE 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)