podman-volume-rm(1)

💖 podman-volume-rm(1) 💖

okay bestie, welcome to the General Commands Manual entry for podman-volume-rm — yes, the one and only volume-deleter. pull up a chair, we're doing some spring cleaning 🧹✨

---

✨ NAME ✨

podman-volume-rm — remove one or more volumes 🗑️💅

---

✨ SYNOPSIS ✨

podman volume rm [options] volume [...]

---

✨ DESCRIPTION ✨

so basically: this removes one or more volumes. that's the whole vibe. but like, only volumes that aren't being used get removed — if a container is currently using a volume, you get an error back 😭 unless you're rocking the --force flag, in which case it's giving "we're doing this anyway".

wanna nuke literally every volume? that's the --all flag, iconic. and you can also remove volumes one at a time by handing over either their full name or a unique partial name. cute, flexible, we love her 🫶

---

✨ OPTIONS ✨

• --all, -a — remove all volumes. every single one. bye 👋
• --force, -f — remove a volume by force. if it's being used by containers, the containers get removed first. no cap, that's the deal.
• --help — print usage statement 📜
• --time, -t=seconds — how many seconds to wait before forcibly stopping running containers that are using the specified volume. heads up bestie: the --force option must be specified to use the --time option. use -1 for an infinite wait ⏳

---

✨ EXAMPLES ✨

remove multiple specified volumes. look at you, so organised 🌸

$ podman volume rm myvol1 myvol2

remove all volumes. clean slate era 🔥

$ podman volume rm --all

remove the specified volume even if it is in use. note: this removes all containers using the volume. it's giving chaos but make it intentional 💀

$ podman volume rm --force myvol

---

✨ Exit Status ✨

• 0 — all specified volumes removed ✅ slay
• 1 — one of the specified volumes did not exist, and no other failures 🙈
• 2 — one of the specified volumes is being used by a container 🚫
• 125 — the command fails for any other reason 💀

---

✨ SEE ALSO ✨

podman(1), podman-volume(1) — go read the family, they're all icons 👑

---

✨ HISTORY ✨

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

---

and that's the whole page, bestie!! this was the podman-volume-rm(1) manual page, living under the General Commands Manual umbrella — mwah, go forth and delete responsibly 💖✨🦋