podman-volume-prune(1) General Commands Manual podman-volume-prune(1)

# [NAME](#NAME)

podman-volume-prune - Remove all unused volumes

# [SYNOPSIS](#SYNOPSIS)

**podman volume prune** \[*options*]

# [DESCRIPTION](#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](#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](#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](#SEE_ALSO)

[**podman(1)**](/man/enterprise-packages/podman-fips-5.8/podman.1), [**podman-volume(1)**](/man/enterprise-packages/podman-fips-5.8/podman-volume.1)

# [HISTORY](#HISTORY)

November 2018, Originally compiled by Urvashi Mohnani umohnani@redhat.com ⟨mailto:umohnani@redhat.com⟩

---

Document: podman-volume-prune(1) from podman-fips-5.8 5.8.9-r0 (Chainguard OS)
Source: https://github.com/containers/podman
