NAME

       podman-image-mount - Mount an image's root filesystem

SYNOPSIS

       podman image mount [options] [image ...]

DESCRIPTION

       Mounts the specified images' root file system in a location which can be accessed from the
       host, and returns its location.

       If you execute the command without any arguments, Podman will list all  of  the  currently
       mounted images.

       Rootless  mode  only supports mounting VFS driver, unless you enter the user namespace via
       the podman unshare command. All other storage drivers will fail to mount.

RETURN VALUE

       The location of the mounted file system.  On error an empty string and errno is returned.

OPTIONS

   --all, -a
       Mount all images.

   --format=format
       Print the mounted images in specified format (json).

EXAMPLE

              podman image mount fedora ubi8-init

              /var/lib/containers/storage/overlay/f3ac502d97b5681989dff84dfedc8354239bcecbdc2692f9a639f4e080a02364/merged
              /var/lib/containers/storage/overlay/0ff7d7ca68bed1ace424f9df154d2dd7b5a125c19d887f17653cbcd5b6e30ba1/merged

              podman mount

              registry.fedoraproject.org/fedora:latest /var/lib/containers/storage/overlay/f3ac502d97b5681989dff84dfedc8354239bcecbdc2692f9a639f4e080a02364/merged
              registry.access.redhat.com/ubi8-init:latest /var/lib/containers/storage/overlay/0ff7d7ca68bed1ace424f9df154d2dd7b5a125c19d887f17653cbcd5b6e30ba1/merged

              podman image mount --format json
              [
               {
                "id": "00ff39a8bf19f810a7e641f7eb3ddc47635913a19c4996debd91fafb6b379069",
                "Names": [
                 "sha256:58de585a231aca14a511347bc85b912a6f000159b49bc2b0582032911e5d3a6c"
                ],
                "Repositories": [
                 "registry.fedoraproject.org/fedora:latest"
                ],
                "mountpoint": "/var/lib/containers/storage/overlay/0ccfac04663bbe8813b5f24502ee0b7371ce5bf3c5adeb12e4258d191c2cf7bc/merged"
               },
               {
                "id": "bcc2dc9a261774ad25a15e07bb515f9b77424266abf2a1252ec7bcfed1dd0ac2",
                "Names": [
                 "sha256:d5f260b2e51b3ee9d05de1c31d261efc9af28e7d2d47cedf054c496d71424d63"
                ],
                "Repositories": [
                 "registry.access.redhat.com/ubi8-init:latest"
                ],
                "mountpoint": "/var/lib/containers/storage/overlay/d66b58e3391ea8ce4c81316c72e22b332618f2a28b461a32ed673e8998cdaeb8/merged"
               }
              ]

SEE ALSO

       podman(1), podman-image(1), podman-image-umount(1), podman-unshare(1), mount(8)

                                                                            podman-image-mount(1)