github.com/hanks177/podman/v4@v4.1.3-0.20220613032544-16d90015bc83/docs/source/markdown/podman-volume-rm.1.md (about) 1 % podman-volume-rm(1) 2 3 ## NAME 4 podman\-volume\-rm - Remove one or more volumes 5 6 ## SYNOPSIS 7 **podman volume rm** [*options*] *volume* [...] 8 9 ## DESCRIPTION 10 11 Removes one or more volumes. Only volumes that are not being used will be removed. 12 If a volume is being used by a container, an error will be returned unless the **--force** 13 flag is being used. To remove all volumes, use the **--all** flag. 14 Volumes can be removed individually by providing their full name or a unique partial name. 15 16 ## OPTIONS 17 18 #### **--all**, **-a** 19 20 Remove all volumes. 21 22 #### **--force**, **-f** 23 24 Remove a volume by force. 25 If it is being used by containers, the containers will be removed first. 26 27 #### **--help** 28 29 Print usage statement 30 31 #### **--time**, **-t**=*seconds* 32 33 Seconds to wait before forcibly stopping running containers that are using the specified volume. The --force option must be specified to use the --time option. 34 35 ## EXAMPLES 36 37 ``` 38 $ podman volume rm myvol1 myvol2 39 40 $ podman volume rm --all 41 42 $ podman volume rm --force myvol 43 ``` 44 45 ## Exit Status 46 **0** All specified volumes removed 47 48 **1** One of the specified volumes did not exist, and no other failures 49 50 **2** One of the specified volumes is being used by a container 51 52 **125** The command fails for any other reason 53 54 ## SEE ALSO 55 **[podman(1)](podman.1.md)**, **[podman-volume(1)](podman-volume.1.md)** 56 57 ## HISTORY 58 November 2018, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>