docker-image-unmount(1)

Usage

podman image unmount [options] image []

podman image umount [options] image []

Overview

Unmounts the specified images' root file system, if no other processes are using it.

Image storage increments a mount counter each time an image is mounted. When an image is unmounted, the mount counter is decremented, and the image's root filesystem is physically unmounted only when the mount counter reaches zero indicating no other processes are using the mount. An unmount can be forced with the --force flag.

Options

--all, -a

All of the currently mounted images are unmounted.

--force, -f

Force the unmounting of specified images' root file system, even if other processes have mounted it.

Note: Other processes using the file system can fail if the mount point is removed without their knowledge.

Examples

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

History

Arch Linux 2026-11-01: the text shown here
Debian 13 (Trixie)
Debian 12 (Bookworm)