github.com/containers/podman/v5@v5.1.0-rc1/docs/source/markdown/podman-unmount.1.md.in (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 are 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: Other processes can fail if the mount point they are using is removed without their knowledge.
    40  
    41  @@option latest
    42  
    43  ## EXAMPLE
    44  
    45  Unmount container with a given ID:
    46  ```
    47  podman container unmount containerID
    48  ```
    49  
    50  Unmount multiple containers with given IDs:
    51  ```
    52  podman unmount containerID1 containerID2 containerID3
    53  ```
    54  
    55  Unmount all containers:
    56  ```
    57  podman unmount --all
    58  ```
    59  
    60  ## SEE ALSO
    61  **[podman(1)](podman.1.md)**, **[podman-mount(1)](podman-mount.1.md)**, **[podman-image-mount(1)](podman-image-mount.1.md)**