Access and modify virtual machine disk images
  • Overview
  • Builds
  • Updates
  • Bugs
  • Contents
  • Changelog
  • Sources
  • Relationships


Libguestfs is a library for accessing and modifying guest disk images. Amongst the things this is good for: making batch configuration changes to guests, getting disk used/free statistics (see also: virt-df), migrating between virtualization systems (see also: virt-p2v), performing partial backups, performing partial guest clones, cloning guests and changing registry/UUID/hostname info, and much else besides. Libguestfs uses Linux kernel and qemu code, and can access any type of guest filesystem that Linux and qemu can, including but not limited to: ext2/3/4, btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, qcow2, vmdk. Libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, what filesystem is in each LV, etc.). It can also run commands in the context of the guest. Libguestfs is a library that can be linked with C and C++ management programs. For high level virt tools, guestfish (shell scripting and command line access), and guestmount (mount guest filesystems using FUSE), install 'libguestfs-tools'. For shell scripting and command line access, install 'guestfish'. To mount guest filesystems on the host using FUSE, install 'libguestfs-mount'. For extra features, install 'libguestfs-gfs2', 'libguestfs-hfsplus', 'libguestfs-jfs', 'libguestfs-nilfs', 'libguestfs-reiserfs', 'libguestfs-rescue', 'libguestfs-rsync', 'libguestfs-xfs', 'libguestfs-zfs'. For Erlang bindings, install 'erlang-libguestfs'. For GObject bindings and GObject Introspection, install 'libguestfs-gobject-devel'. For Golang bindings, install 'golang-guestfs'. For Java bindings, install 'libguestfs-java-devel'. For Lua bindings, install 'lua-guestfs' For OCaml bindings, install 'ocaml-libguestfs-devel'. For Perl bindings, install 'perl-Sys-Guestfs'. For PHP bindings, install 'php-libguestfs'. For Python bindings, install 'python-libguestfs'. For Ruby bindings, install 'ruby-libguestfs'.

Active Releases Overview

Release Latest Released Version Version in Testing
{{html release}} 
{{html stable_version}} {{html testing_version}}

Upstream Summary

Project Homepage


karsten's libguestfs-1.22.3-1.fc19 failed to build (ppc)

9 hours ago - 2014-04-19 10:37:16

karsten's libguestfs-1.22.3-1.fc19 started building (ppc)

9 hours ago - 2014-04-19 10:05:19

karsten's libguestfs-1.22.4-2.fc19 failed to build (ppc)

10 hours ago - 2014-04-19 09:46:35

karsten's libguestfs-1.22.4-2.fc19 started building (ppc)

10 hours ago - 2014-04-19 09:43:29


rjones pushed to libguestfs (master). "Remove /var/run/libguestfs, which is not used."

3 days ago - 2014-04-16 18:55:02

Found a bug? File a ticket. Note: There's some caching going on here. If you expect something and don't see it, check back in 5 minutes.

This Web Site is licensed under the GNU Affero General Public License. You may get sources for the current running code from these repositories: