plucky (1) podman-volume-prune.1.gz

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)