podman-unmount(1)

✨ podman-unmount(1) ✨

okay bestie, welcome to podman-unmount — the part of the General Commands Manual where we take a working container's root filesystem and go "you're done here, queen" 💅

---

🌸 NAME 🌸

podman-unmount — unmount a working container's root filesystem

---

🦋 SYNOPSIS 🦋

podman unmount [options] container [...]

podman umount [options] container [...]

podman container unmount [options] container [...]

podman container umount [options] container [...]

like yes, there are four whole ways to spell it, and all of them slay equally 🫶

---

💖 DESCRIPTION 💖

So here's the tea: this unmounts the root file system of the containers you point at — but only if no other processes are using it. if somebody else is still vibing in there, it stays mounted, no cap.

Container storage keeps a lil mount counter that goes up every single time a container gets mounted. when you unmount a container, that counter goes down, and the container's root filesystem only gets physically unmounted when the counter hits zero — which is the signal that literally nobody else is using that mount. if you're impatient and you want it gone anyway, you can force it with the --force flag. 💪

Note: Podman can unmount Podman containers and external containers. external containers are containers created in container/storage by other tools like Buildah and CRI-O. so yeah, we're inclusive like that 🌈

---

🎀 OPTIONS 🎀

• --all, -a — every single currently mounted container gets unmounted. all of them. the whole friend group. 💀
• --force, -f — force the unmounting of the specified containers' root file system, even if other processes have mounted it. dramatic, but okay.

Note: other processes can fail if the mount point they're using gets removed without their knowledge. so like... be aware, bestie. this is a real one. 😭

• --latest, -l — instead of giving a container name or ID, just use the last created container. note: the last started container can be from other users of Podman on the host machine. (this option is not available with the remote Podman client, including Mac and Windows machines — excluding WSL2. 🙈)

---

🌟 EXAMPLE 🌟

Unmount container with a given ID:

podman container unmount containerID

Unmount multiple containers with given IDs:

podman unmount containerID1 containerID2 containerID3

Unmount all containers:

podman unmount --all

Force umount container with given ID:

podman umount --force containerID

---

👑 SEE ALSO 👑

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

---

and that's the whole page, bestie — podman-unmount(1) from the General Commands Manual, written and dated with love. go forth and unmount responsibly 💖✨🎀🦋