github.com/containers/podman/v5@v5.1.0-rc1/docs/source/markdown/podman-image-unmount.1.md (about)

     1  % podman-image-unmount 1
     2  
     3  ## NAME
     4  podman\-image\-unmount - Unmount an image's root filesystem
     5  
     6  ## SYNOPSIS
     7  **podman image unmount** [*options*] *image* [...]
     8  
     9  **podman image umount** [*options*] *image* [...]
    10  
    11  ## DESCRIPTION
    12  Unmounts the specified images' root file system, if no other processes
    13  are using it.
    14  
    15  Image storage increments a mount counter each time an image is mounted.
    16  When an image is unmounted, the mount counter is decremented, and the
    17  image's root filesystem is physically unmounted only when the mount
    18  counter reaches zero indicating no other processes are using the mount.
    19  An unmount can be forced with the --force flag.
    20  
    21  ## OPTIONS
    22  #### **--all**, **-a**
    23  
    24  All of the currently mounted images are unmounted.
    25  
    26  #### **--force**, **-f**
    27  
    28  Force the unmounting of specified images' root file system, even if other
    29  processes have mounted it.
    30  
    31  Note: Other processes using the file system can fail if the mount point is removed without their knowledge.
    32  
    33  ## EXAMPLE
    34  
    35  Unmount image with a given ID:
    36  ```
    37  podman image unmount imageID
    38  ```
    39  
    40  Unmount multiple images with given IDs:
    41  ```
    42  podman image unmount imageID1 imageID2 imageID3
    43  ```
    44  
    45  Unmount all images:
    46  ```
    47  podman image unmount --all
    48  ```
    49  ## SEE ALSO
    50  **[podman(1)](podman.1.md)**, **[podman-image-mount(1)](podman-image-mount.1.md)**, **[podman-mount(1)](podman-mount.1.md)**