Guestmount

guestmount command mount a guest filesystem on the host using FUSE and libguestfs. It is included in libguestfs-tools package.

• Man page: https://linux.die.net/man/1/guestmount

Examples

• guestmount -a path_to_image.qcow2 -i --ro /mount_point
• guestmount -a path_to_image.qcow2 -i --rw /mount_point

Verify:
mount
.../...
/dev/fuse on /mount/path type fuse (rw,nosuid,nodev,relatime,user_id=0,group_id=0)
.../...

-a your_image.qcow2

-i --inspector  inspect the disks looking for an operating system and mount filesystems as they would be mounted on the real virtual machine
-m mount

guestmount -a path_to_image.qcow2 -i --ro /mount_point

 guestmount: no operating system was found on this disk

 If using guestfish '-i' option, remove this option and instead
 use the commands 'run' followed by 'list-filesystems'.
 You can then mount filesystems you want by hand using the
 'mount' or 'mount-ro' command.

 If using guestmount '-i', remove this option and choose the
 filesystem(s) you want to see by manually adding '-m' option(s).
 Use 'virt-filesystems' to see what filesystems are available.

 If using other virt tools, this disk image won't work
 with these tools.  Use the guestfis

libguestfs: error: findfs_uuid: findfs: unable to resolve 'UUID=8bc77dbf-2217-11e9-bf56-525400670XXX'

guestmount -a IMAGE.qcow2  --rw ./mount_point
guestmount: error: you must specify either -i at least one -m option.
Try ‘guestmount --help’ for more information.

guestmount -a your_image.qcow2 -i --ro ./dest_path/
libguestfs: error: /usr/bin/supermin exited with error status 1.
To see full error messages you may need to enable debugging.
Do:
  export LIBGUESTFS_DEBUG=1 LIBGUESTFS_TRACE=1
and run the command again.  For further information, read:
 http://libguestfs.org/guestfs-faq.1.html#debugging-libguestfs
You can also run 'libguestfs-test-tool' and post the *complete* output
into a bug report or message to the libguestfs mailing list.

 Solution: execute as root user

Related commands

• virt-filesystems -a --all --long -h output.img
• virt-inspector
• findfs
• mount
• guestfish
• virt-rescue
• qemu-nbd

See also

• KVM, Installation, QEMU, virsh, virtinst, libguestfs-tools, libvirt, qemu, Red Hat Virtualization (RHV), MacVTap, Virtio, oVirt, KVM services, KVM networking, KVM graphics, CPU, KVM on ARM
• libguestfs-tools: virt-sysprep, virt-clone, virt-builder, virt-customize, virt-resize, virt-rescue, virt-sparsify, guestmount, guestfish, virt-inspector, virt-cat, virt-log, virt-df, virt-ls, virt-filesystems, virt-list-filesystems, virt-edit