github.com/hanks177/podman/v4@v4.1.3-0.20220613032544-16d90015bc83/docs/source/markdown/podman-unmount.1.md (about)

     1  % podman-unmount(1)
     2  
     3  ## NAME
     4  podman\-unmount - Unmount a working container's root filesystem
     5  
     6  ## SYNOPSIS
     7  **podman unmount** [*options*] *container* [...]
     8  
     9  **podman umount** [*options*] *container* [...]
    10  
    11  **podman container unmount** [*options*] *container* [...]
    12  
    13  **podman container umount** [*options*] *container* [...]
    14  
    15  ## DESCRIPTION
    16  Unmounts the specified containers' root file system, if no other processes
    17  are using it.
    18  
    19  Container storage increments a mount counter each time a container is mounted.
    20  When a container is unmounted, the mount counter is decremented, and the
    21  container's root filesystem is physically unmounted only when the mount
    22  counter reaches zero indicating no other processes are using the mount.
    23  An unmount can be forced with the --force flag.
    24  
    25  Note: Podman can be used to unmount Podman containers as well as external containers.
    26  External containers are containers created in container/storage by other tools like
    27  Buildah and CRI-O.
    28  
    29  ## OPTIONS
    30  #### **--all**, **-a**
    31  
    32  All of the currently mounted containers will be unmounted.
    33  
    34  #### **--force**, **-f**
    35  
    36  Force the unmounting of specified containers' root file system, even if other
    37  processes have mounted it.
    38  
    39  Note: This could cause other processes that are using the file system to fail,
    40  as the mount point could be removed without their knowledge.
    41  
    42  #### **--latest**, **-l**
    43  
    44  Instead of providing the container name or ID, use the last created container.
    45  If you use methods other than Podman to run containers such as CRI-O, the last
    46  started container could be from either of those methods. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)
    47  
    48  ## EXAMPLE
    49  
    50  Unmount container with a given ID
    51  ```
    52  podman container unmount containerID
    53  ```
    54  
    55  Unmount multiple containers with given IDs
    56  ```
    57  podman unmount containerID1 containerID2 containerID3
    58  ```
    59  
    60  Unmount all containers
    61  ```
    62  podman unmount --all
    63  ```
    64  
    65  ## SEE ALSO
    66  **[podman(1)](podman.1.md)**, **[podman-container-mount(1)](podman-container-mount.1.md)**, **[podman-image-mount(1)](podman-image-mount.1.md)**