podman-image-unmount(1)

✨ podman-image-unmount(1) ✨

okay bestie, welcome to the General Commands Manual section of your life 💅 this is the page for podman-image-unmount, and it's literally about letting go of an image's root filesystem. iconic behavior, honestly.

---

🎀 NAME 🎀

podman-image-unmount — unmount an image's root filesystem 🦋

---

🌸 SYNOPSIS 🌸

podman image unmount [options] image [...]

podman image umount [options] image [...]

---

💖 DESCRIPTION 💖

So the whole vibe here: this unmounts the specified images' root file system, if no other processes are using it. if it's busy, bestie, it stays mounted, that's just the rules 🙈

Here's the lore 🧚 image storage keeps a little mount counter, and it increments every single time an image gets mounted. so when you unmount, the counter goes down, and the image's root filesystem only actually gets physically unmounted when that counter hits zero — which is the moment that means no other processes are using the mount. slay. 💅

and if you're feeling bold? an unmount can be forced with the --force flag. main character energy fr fr 🔥

---

⭐ OPTIONS ⭐

• --all, -a — all of the currently mounted images are unmounted. every last one. periodt. 👑
• --force, -f — force the unmounting of the specified images' root file system, even if other processes have mounted it. dramatic? yes. useful? also yes.

Note: other processes using the file system can fail if the mount point is removed without their knowledge. like, they will not know. and they will not be okay about it. 💀

---

🌈 EXAMPLE 🌈

Unmount image with a given ID:

podman image unmount imageID

Unmount multiple images with given IDs:

podman image unmount imageID1 imageID2 imageID3

Unmount all images:

podman image unmount --all

Force unmount image with a given ID:

podman image unmount --force imageID

---

👑 SEE ALSO 👑

podman(1), podman-image-mount(1), podman-mount(1)

---

and that's the whole page, no cap 🫶 this was the podman-image-unmount(1) manual page, brought to you by the General Commands Manual squad. go forth, unmount responsibly, and remember: counter hits zero, filesystem says bye ✨💖