ANNOUNCE: virt-v2v 2.12 released
by Richard W.M. Jones
I'm pleased to announce the latest stable release of virt-v2v, 2.12.
Virt-v2v is a tool that can automatically convert VMs from foreign
hypervisors like VMware over to KVM. This version has a few new
features and extends compatibility over more types of guests.
The release notes for this version can be found online at this link,
or attached below.
https://libguestfs.org/virt-v2v-release-notes-2.12.1.html
Tarballs from:
https://download.libguestfs.org/virt-v2v/2.12-stable/
Rich.
Virt-v2v 2.12.0 was released on 10 July 2026.
New features
Enable conversions of Debian 12 guests that use UEFI (Martin Necas).
Enable conversions of SLES 12 SP5 and Ubuntu 24.04 that use LUKS encrypted
filesystems (Cole Robinson).
Enable conversions of Kylin, NeoKylin and Anolis Linux distributions
(grass lu).
Add new --no-fstrim option to disable fstrim during conversion (sarika at
Platform 9).
New --collect option which can be used to collect pre-conversion informa‐
tion such as the Windows Registry and event log for later diagnosis
(thanks Vadim Rozenfeld).
The -i disk input method now allows "nbd://..." URIs to be used instead of
local disks. This allows more flexible conversions such as converting
from xz-compressed images.
virt-v2v-inspector(1) now includes information about XFSv4 and XFSv5
filesystems.
virt-v2v-in-place(1) and virt-v2v-inspector XML output now contains sug‐
gested disk boot order information (thanks Elad Hazan).
Other fixes
Fix detection of remote files when using -it ssh mode (Ming Xie).
When injecting virtio-win drivers in Windows guests, install blnsvr.exe
(the balloon server) (Cole Robinson).
Fix installation of Windows Vista and Windows 2008 Server R1 drivers (Cole
Robinson).
Stop using xfs_repair -m option (thanks Ming Xie, Eric Sandeen, Dave Chin‐
ner).
Ignore AGFL inconsistencies in XFS filesystems on RHEL 7 guests (thanks
Brian Foster, Eric Sandeen).
Retry Windows qemu-guest-agent installer several times to work around tem‐
porary installation bugs (thanks Martin Necas, Cole Robinson).
Virt-v2v --key parameter now allows binary keys.
Virt-v2v --firstboot scripts on Windows may now exit with code 250 to
avoid rebooting after the script (Srihari Parimi).
Immutable /etc/resolv.conf no longer prevents conversion (Srihari Parimi).
Obey cgroup v2 CPU limits (Susant Sahani).
Fix output filenames if guest name contains "/" character (Susant Sahani).
Documentation
Document how to recover the key used by Windows guests that stored the
Bitlocker disk encryption key in the VMware vTPM (Ming Xie).
Document pre-conversion steps required for certain guests encrypted with
LUKS using vTPM (Ming Xie, Susant Sahani).
Fix conversion from VMware vCenter where the VMware datastore name con‐
tains some special characters (Cole Robinson).
Document that the PowerShell execution policy "AllSigned" will not work
(thanks Martin Mecas, Ulhas Surse).
Build changes
Fix Weblate (i18n) web hooks (Rafael Fontenelle).
Fix and enhance github CI checks (Cole Robinson).
Remove "AM_GNU_GETTEXT" macro and replace it with simpler "LIBINTL" checks
(Cole Robinson).
Various build warnings were cleaned up (Cole Robinson).
Fix warnings in configure script related to the order that various auto‐
conf macros appear (Olaf Hering).
Internals
Many memory leaks identified by Claude Code were fixed (shivanayak).
Improve debug output (Srihari Parimi).
Bugs fixed
https://issues.redhat.com/browse/MTV-4424
[MTV] Migration of windows 2019 VM fails to install qemu-ga and set
static IP if ExecutionPolicy is set in souce VM.
https://issues.redhat.com/browse/RHEL-85154
ubuntu guest with encrypted disk and TPM fails boot into OS after v2v
conversion
https://issues.redhat.com/browse/RHEL-93583
sles12sp5 guest with encrypted brtfs fliesystem fails to boot into OS
after v2v conversion
https://issues.redhat.com/browse/RHEL-103915
win11 guest with vtpm and bitlocker enabled will power off automati‐
cally if the user does not enter the key in 1 minute after v2v conver‐
sion [docs only]
https://issues.redhat.com/browse/RHEL-133729
virt-v2v migration from vSphere fails when datastore name has charac‐
ters like '+' [rhel-10.2]
https://issues.redhat.com/browse/RHEL-136479
v2v fails to create the disk on target if the source guest contains
specific characters like '*+_/'
https://issues.redhat.com/browse/RHEL-137121
encrypted ubuntu installation fails to boot after conversion
https://issues.redhat.com/browse/RHEL-144075
Expose XFS version in virt-v2v-inspector
https://issues.redhat.com/browse/RHEL-144467
[MTV] Debian UEFI VM fails to boot after migrating to Openshift Virtu‐
alzation.
https://issues.redhat.com/browse/RHEL-148423
blnsvr.exe running from C:\Program Files\Guestfs\Firstboot\Temp
https://issues.redhat.com/browse/RHEL-152939
Create sentinel file after all firstboot scripts have finished running
https://issues.redhat.com/browse/RHEL-164271
Add virt-v2v-in-place --no-fstrim option
https://issues.redhat.com/browse/RHEL-165677
Stop using xfs_repair -m because memory required scales with filesys‐
tem size and has sharp edges
https://issues.redhat.com/browse/RHEL-170864
virt-v2v failing with binary LUKS keys [virt-v2v]
https://issues.redhat.com/browse/RHEL-178287
virt-v2v fails during migration of RHEL 7 VMs due to XFS filesystem
errors, potentially related to RHEL 10.1 xfs_repair running against a
RHEL 7 XFS filesystem.
https://issues.redhat.com/browse/RHEL-178432
regression converting ubuntu24.04
https://issues.redhat.com/browse/RHEL-178556
Use bind mount to overwrite /sysroot/etc/resolv.conf during "sh" oper‐
ations
https://issues.redhat.com/browse/RHEL-184508
Set boot disk index for guests in virt-v2v-in-place / inspection XML
output
https://issues.redhat.com/browse/RHEL-188772
RFE: virt-v2v option to collect Windows registry and event logs and
other useful information
https://issues.redhat.com/browse/RHEL-191749
virt-v2v fails during migration of RHEL 7 VMs due to XFS filesystem
errors, potentially related to RHEL 10.1 xfs_repair running against a
RHEL 7 XFS filesystem [virt-v2v]
SEE ALSO
virt-v2v(1).
AUTHORS
Authors of virt-v2v 2.12:
Andi Chandler
Arif Budiman
Cole Robinson
Emilio Herrera
Ettore Atalan
Fco. Javier F. Serrador
grass lu
grimst
Hela Basa
Jan Kuparinen
Krascovict Petrov
Martin Necas
Nathan95
Olaf Hering
Pavel Borecki
Piotr Drąg
Rafael Fontenelle
Richard W.M. Jones
Ricky Tigg
sarika
Susant Sahani
Temuri Doghonadze
Tim Wiederhake
Yuri Chornoivan
--
Richard Jones, Virtualization Group, Red Hat http://people.redhat.com/~rjones
Read my programming and virtualization blog: http://rwmj.wordpress.com
virt-builder quickly builds VMs from scratch
http://libguestfs.org/virt-builder.1.html
3 days, 3 hours
ANNOUNCE: guestfs-tools 1.56 released
by Richard W.M. Jones
I'm pleased also to announce the release of guestfs-tools 1.56.
Guestfs tools are a set of utilities for manipulating disk images,
virtual machine disks and similar files. This is a roll up release
from about a year of upstream work. Thanks in particular to Cole
Robinson for fixing a ton of bugs in this release and fixing our
upstream CI.
Note you will need to update to libguestfs 1.60 first.
Release notes attached below, or you can read them online here:
https://libguestfs.org/guestfs-tools-release-notes-1.56.1.html
Tarballs from:
https://download.libguestfs.org/guestfs-tools/1.56-stable/
Rich.
Guestfs tools 1.56.0 was released on 9 July 2026.
virt-builder
Fix building of "debian-13" template (pulsarrush).
Use HTTPS to fetch templates (Xiang Hua Chen).
virt-customize
Fix SELinux relabelling of "split /usr" guests.
Fix Windows Update and "pnputil /e" command in Windows guests after vir‐
tio-win drivers are injected (Cole Robinson).
When injecting virtio-win drivers in Windows guests, install blnsvr.exe
(the balloon server) (Cole Robinson).
Fix installation of Windows Vista and Windows 2008 Server R1 drivers (Cole
Robinson).
Remove the RHEL subscription-manager feature (Cole Robinson).
In firstboot scripts, print Windows "%USERNAME%" and "%USERDOMAIN%" which
can be used to diagnose failures caused by insufficient permissions (Ming
Xie).
Windows firstboot scripts may now exit with code 250, meaning that no re‐
boot is required after the script. The next script in sequence runs imme‐
diately (Srihari Parimi).
On Windows, a sentinel file is created after all firstboot scripts have
run, which may be used to indicate that firstboot has completed.
virt-inspector
Add "<windows_group_policy/>" if Windows Group Policy was detected inside
a guest.
New "<class>" element used to indicate the category of applications, such
as antivirus.
For XFS filesystems, new "<type version="4|5">" to indicate XFSv4 or
XFSv5. (This is also displayed in virt-filesystems(1) output.)
Add support for Kylin, NeoKylin and Anolis Linux (grass lu).
virt-sysprep
Add a new operation to clean zsh history files (Fazle Arefin).
Common changes
Some bash completion scripts that were no longer used by guestfs-tools
were removed. Also new "./configure --with-bash-completion" and "./con‐
figure --with-bash-completion-dir" options were added (Christopher Byrne).
All tools taking a LUKS key file now allow a binary file to be used.
Documentation
Use qemu option -cpu max in documentation about running virt-builder
guests.
All information related to firstboot scripts was moved to and consolidated
in "FIRSTBOOT" in virt-customize(1) (Srihari Parimi).
Removed a lot of obsolete documentation in the virt-sysprep(1) man page.
Build changes
Fix Weblate (i18n) web hooks (Rafael Fontenelle).
Fixes for OCaml 5.
Add github CI (Cole Robinson).
Remove "AM_GNU_GETTEXT" macro and replace it with simpler "LIBINTL" checks
(Cole Robinson).
Build Bison-based parser with -Wno-yacc to reduce yacc compatibility warn‐
ings that we don't care about (Cole Robinson).
Various build warnings were cleaned up (Cole Robinson).
"CFLAGS" is now prepended to the default, allowing default flags to be
overridden. In addition -fPIC is added to the default flags (Cole Robin‐
son).
Many memory leaks identified by Claude Code were fixed (shivanayak).
Internals
OCaml quoted string literals ("{|..|}") are used throughout the code to
make it easier to include verbatim scripts, code, regexps etc.
The sources for virt-cat(1), virt-filesystems(1), virt-log(1), virt-ls(1)
and virt-tail(1) previously used a single source directory (cat/) for no
particular reason. These were moved to separate directories.
Bugs fixed
https://issues.redhat.com/browse/RHEL-100682
Installing drivers on firstboot sometimes fail with PnP service not
available [rhel-9.7]
https://issues.redhat.com/browse/RHEL-108174
selinux-relabel doesn't work across filesystem boundaries (because
setfiles doesn't) [rhel-9.7]
https://issues.redhat.com/browse/RHEL-125955
virt-inspector detect if AV/GPOs are present in a VM [guestfs tools]
https://issues.redhat.com/browse/RHEL-144074
Expose XFS version in virt-filesystems
https://issues.redhat.com/browse/RHEL-170706
Virt-customize firstboot scripts (on Windows) should be able to skip
reboots
https://issues.redhat.com/browse/RHEL-170708
Document that exit code 249 means we retry the firstboot script (Win‐
dows only)
https://issues.redhat.com/browse/RHEL-171896
virt-v2v failing with binary LUKS keys [guestfs-tools]
https://issues.redhat.com/browse/RHEL-94873
Need to update uri to https:// for conf file in /etc/virt-builder/re‐
pos.d [rhel-10.1]
SEE ALSO
http://libguestfs.org/
AUTHORS
Christopher Byrne
Cole Robinson
Fazle Arefin
Fco. Javier F. Serrador
pulsarrush
Rafael Fontenelle
Richard W.M. Jones
Srihari Parimi
Temuri Doghonadze
Yuri Chornoivan
--
Richard Jones, Virtualization Group, Red Hat http://people.redhat.com/~rjones
Read my programming and virtualization blog: http://rwmj.wordpress.com
nbdkit - Flexible, fast NBD server with plugins
https://gitlab.com/nbdkit/nbdkit
4 days, 2 hours
ANNOUNCE: libguestfs 1.60 released
by Richard W.M. Jones
I'm happy to announce the release of libguestfs 1.60. Libguestfs is a
comprehensive library and set of tools for creating and manipulating
disk images and virtual machine disks and similar files.
This release is largely a maintenance release, but I'd like to
highlight the contributions from Rafael Fontenelle and other
translators in getting the translations (from the Fedora Weblate
project) back up and working again.
Release notes are attached below, or can be found online here:
https://libguestfs.org/guestfs-release-notes-1.60.1.html
Tarballs from:
https://download.libguestfs.org/1.60-stable/
It'll be available in Linux distros soon.
Rich.
----------------------------------------------------------------------
Libguestfs 1.60.0 was released on 9 July 2026.
Inspection
Add support for Kylin, NeoKylin and Anolis Linux distributions (grass lu).
Guests using Veritas partition tables (reusing the Sun partition type) can
now be inspected.
Windows Defender (antivirus) is now detected if present in Windows guests
(Susant Sahani).
API
New "guestfs_xfs_info2" API. This is similar to the existing
"guestfs_xfs_info" API but returns a flexible hashtable allowing more
fields to be added to the output in future.
"guestfs_get_hv" now returns the default hypervisor.
"guestfs_tar_in" adds a new option "keepdirlink" which controls the tar
--keep-directory-symlink flag (Anders Roxell).
"guestfs_xfs_repair" "maxmem" option now produces better error messages if
maxmem is too small.
All functions that take LUKS key parameters may now use either "text:..."
or "base64:..." prefixes, allowing binary keys to be encoded as base64 and
passed to these APIs. guestfish(1) and other tools taking a key file now
allow a binary file to be used.
"guestfs_command*" and "guestfs_sh*" now use a bind mount to override
"/etc/resolv.conf" inside the guest, allowing these commands to work even
when this file is marked as immutable, a common change that system admin‐
istrators make (Srihari Parimi).
Tools
New guestfish(1) "not" subcommand, which negates the status of a command.
Language bindings
GObject and Vala bindings were removed. They were previously deprecated
in libguestfs 1.56 (Cole Robinson).
Documentation
All information related to firstboot scripts was moved to and consolidated
in "FIRSTBOOT" in virt-customize(1) (Srihari Parimi).
Fix documentation of "guestfs_copy_out" API.
Build changes
Fix Weblate (i18n) web hooks (Rafael Fontenelle).
Fix build when libselinux is not available (David Runge).
Github CI is now used more comprehensively (Cole Robinson).
Fix "make dist" command when certain language bindings are disabled (Cole
Robinson).
"./configure --with-qemu" was removed.
"CFLAGS" is now prepended to the default, allowing default flags to be
overridden. In addition -fPIC is added to the default flags (Cole Robin‐
son).
Some bash completion scripts that were no longer used by libguestfs (they
moved to guestfs-tools) were removed. Also new "./configure
--with-bash-completion" and "./configure --with-bash-completion-dir" op‐
tions were added (Christopher Byrne).
No longer over-link Lua bindings with libxml2 and libvirt (David Runge).
Internals
Simplify qemu property testing. Most of the code was eliminated com‐
pletely, and also we no longer start up an empty guest when detecting if
KVM is available (thanks Daniel Berrange). Also we now print stderr if
qemu fails to start during detection (Hilko Bengen).
Use -cpu max on RISC-V (thanks Apache553).
Very minimal support for Apple Filesystem (APFS) was added on Fedora.
Many memory and file descriptor leaks found by Claude Code were fixed
(shivanayak).
In the libguestfs appliance, increase the number of pre-process memory
maps. This may allow xfs_repair to work on larger filesystems (Eric
Sandeen).
Fix DHCP on fast machines by making it wait for an address when networking
is enabled. In addition use "dhcpcd --debug" which makes it easier to see
if DHCP requests are working (Cole Robinson).
Improvements to debug output (Surya Gupta, Srihari Parimi).
Fix Fedora bin/sbin symlinking to be less noisy (Cole Robinson).
Rewrite xfs_repair and luks_* implementations in the daemon in OCaml.
Bugs fixed
https://issues.redhat.com/browse/RHEL-129145
RFE: Detect Windows Defender antivirus when enabled in default Windows
11 installs
https://issues.redhat.com/browse/RHEL-143673
Add new xfs_info2 API to expose XFS version information
https://issues.redhat.com/browse/RHEL-165220
virt-v2v with sun partition table and Veritas storage failed with:
parted exited with status 1: Warning: The disk CHS geometry reported
by the operating system does not match the geometry stored on the disk
label
https://issues.redhat.com/browse/RHEL-165677
Stop using xfs_repair -m because memory required scales with filesys‐
tem size and has sharp edges
https://issues.redhat.com/browse/RHEL-170864
virt-v2v failing with binary LUKS keys [virt-v2v]
https://issues.redhat.com/browse/RHEL-171895
virt-v2v failing with binary LUKS keys [libguestfs]
https://issues.redhat.com/browse/RHEL-171896
virt-v2v failing with binary LUKS keys [guestfs-tools]
https://issues.redhat.com/browse/RHEL-178287
virt-v2v fails during migration of RHEL 7 VMs due to XFS filesystem
errors, potentially related to RHEL 10.1 xfs_repair running against a
RHEL 7 XFS filesystem.
https://issues.redhat.com/browse/RHEL-178556
Use bind mount to overwrite /sysroot/etc/resolv.conf during "sh" oper‐
ations
https://github.com/libguestfs/libguestfs/issues/290
1.58.0: undefined reference to optgroup_selinuxrelabel_available
https://github.com/libguestfs/libguestfs/issues/292
guestfs_int_get_cpu_model: use -cpu max for riscv
https://github.com/libguestfs/libguestfs/issues/312
switch to po4a
https://github.com/libguestfs/libguestfs/issues/336
flaky test network/test-network.sh
https://github.com/libguestfs/libguestfs/issues/359
1.58.1: The Lua bindings link against libxml2 but don't seem to use it
SEE ALSO
guestfs-examples(1), guestfs-faq(1), guestfs-performance(1),
guestfs-recipes(1), guestfs-testing(1), guestfs(3), guestfish(1),
http://libguestfs.org/
AUTHORS
Adolfo Jayme Barrientos
Anders Roxell
Andi Chandler
Arif Budiman
Christopher Byrne
Cole Robinson
Emilio Herrera
Ettore Atalan
Fco. Javier F. Serrador
grimst
Hela Basa
Hilko Bengen
Jan Kuparinen
Krascovict Petrov
Léane GRASSER
Nathan95
Pavel Borecki
Piotr Drąg
Rafael Fontenelle
Richard W.M. Jones
Ricky Tigg
shivanayak
Srihari Parimi
Surya Gupta
Susant Sahani
Temuri Doghonadze
Tian Shixiong
Yuri Chornoivan
zhanchun li
--
Richard Jones, Virtualization Group, Red Hat http://people.redhat.com/~rjones
Read my programming and virtualization blog: http://rwmj.wordpress.com
nbdkit - Flexible, fast NBD server with plugins
https://gitlab.com/nbdkit/nbdkit
4 days, 3 hours