guestfs-browser man page

guestfs-browser — Guest filesystem browser


 guestfs-browser [--options]

 guestfs-browser [--options] -d domname

 guestfs-browser [--options] -a disk.img [-a disk.img [...]]


The guest filesystem browser is a graphical program for browsing virtual machine filesystems and disk images interactively.

If you need to make scripted changes or browse disk images from the command line, we suggest you look at guestfish(1) or virt-rescue(1) instead.  If you want to mount a disk image or virtual machine disk on the host, use guestmount(1).

To start guestfs-browser with an empty window, use:


To start guestfs-browser pointing to a disk image file called disk.img, use:

 guestfs-browser -a disk.img

To start guestfs-browser pointing to a libvirt domain called guest, use:

 guestfs-browser [-c libvirtURI] -d guest

Note that this only works for local libvirt guests (at least the browser must be able to read the disks locally).

The program does not need to be run as root, unless root is required in order to access the disk images.  Currently guestfs-browser only accesses the disk image read only.  It is therefore safe to use guestfs-browser on live virtual machines, but you may see strange or inconsistent results.



Add file which should be a disk image.  You can supply multiple disk images by repeating this option.

The format of the disk image is auto-detected.  To override this and force a particular format use the --format=.. option.

-c URI
--connect URI

If using libvirt, connect to the given URI.  If omitted, then we connect to the default libvirt hypervisor.

If you specify guest block devices directly (-a), then libvirt is not used at all.

-d guest
--domain guest

Add all the disks from the named libvirt guest.

--format raw|qcow2|..
--format “”

The default for the -a option is to auto-detect the format of the disk image.  Using this forces the disk format for -a options which follow on the command line.  Using --format with no argument switches back to auto-detection for subsequent -a options.

For example:

 guestfs-browser --format raw -a disk.img

forces raw format (no auto-detection) for disk.img.

 guestfs-browser --format raw -a disk.img --format "" -a another.img

forces raw format (no auto-detection) for disk.img and reverts to auto-detection for another.img.

If you have untrusted raw-format guest disk images, you should use this option to specify the disk format.  This avoids a possible security problem with malicious guests (CVE-2010-3851).


Enable verbose messages for debugging.


Display version number and exit.


Enable tracing of libguestfs API calls.

See Also

guestfs(3), guestfish(1), virt-cat(1), virt-edit(1), virt-rescue(1), <>, <>.


Richard W.M. Jones <>


2013-01-28 guestfs-browser-0.2.1 Virtualization Support