oracular (1) docker-image-mount.1.gz

Provided by: podman_5.0.3+ds1-5ubuntu1_amd64 bug

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.

       The podman image mount command without any arguments lists all of the currently mounted images.

       Rootless mode only supports mounting VFS driver, unless podman is run  in  a  user  namespace.   Use  the
       podman unshare command to enter the user namespace. All other storage drivers 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
       Mount  multiple  images.  Note:  In  rootless  mode, image mounting works only after executing the podman
       unshare command to enter the user namespace.

       podman image mount fedora ubi8-init
       /var/lib/containers/storage/overlay/f3ac502d97b5681989dff84dfedc8354239bcecbdc2692f9a639f4e080a02364/merged
       /var/lib/containers/storage/overlay/0ff7d7ca68bed1ace424f9df154d2dd7b5a125c19d887f17653cbcd5b6e30ba1/merged

       List mounted images:

       podman image 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

       List mounted images in JSON format:

       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-unmount(1), podman-unshare(1), mount(8)

                                                                                           podman-image-mount(1)