Chapter 5. Converting virtual machines to the Q35 machine type


In RHEL 10, the i440fx machine type is deprecated, and will be removed in a future major version of RHEL. Therefore, Red Hat recommends converting your virtual machines (VMs) that use i440fx to use the q35 machine type instead.

In addition, using q35 provides additional benefits in comparison to i440fx, such as Advanced Host Controller Interface (AHCI) and virtual Input-output memory management unit (vIOMMU) emulation.

Note that you can also convert VM configurations that you have not defined yet.

Important

Changing a machine type of a VM is similar to changing the motherboard on a physical machine. As a consequence, converting the machine type of a VM from i440fx to q35 might, in some cases, cause problems with the functionality of the guest operating system.

Prerequisites

  • A VM on your RHEL 10 host is using the i440fx machine type. To confirm this, use the following command:

    # virsh dumpxml <vm-name> | grep machine
    Copy to Clipboard Toggle word wrap

    Example output for an i440fx VM:

    <type arch='x86_64' *machine='pc-i440fx-10.0.0'*>hvm</type>
    Copy to Clipboard Toggle word wrap
  • You have backed up the original configuration of the VM, so you can use it for conversion and disaster recovery, if necessary.

    # virsh dumpxml <vm-name> > <vm-name>-backup.xml
    Copy to Clipboard Toggle word wrap

Procedure

  • For undefined VMs, do the following:

    1. Adjust the configuration of the VM to use Q35. As the source configuration, use the backup file that you created previously.

      # cat <vm-name>-backup.xml | virt-xml --edit --convert-to-q35 > <vm-name-q35>.xml
      Copy to Clipboard Toggle word wrap
    2. Define the VM.

      # virsh define <vm-name-q35>.xml
      Copy to Clipboard Toggle word wrap
  • For defined VMs, do the following:

    1. Adjust the configuration of the VM to use Q35.

      # virt-xml <vm-name> --edit --convert-to-q35
      Copy to Clipboard Toggle word wrap
    2. If the VM is running, shut it down.

      # virsh shutdown <vm-name>
      Copy to Clipboard Toggle word wrap

Verification

  1. Display the machine type of the VM.

    # virsh dumpxml <vm-name> | grep machine
    
        <type arch='x86_64' machine='q35'>hvm</type>
    Copy to Clipboard Toggle word wrap
  2. Start the VM and check that you can log in to the guest operating system.

Troubleshooting

  • If changing the machine type has made the VM not functional, define a new VM based on the backed-up configuration.

    # virsh define <vm-name>-backup.xml
    Copy to Clipboard Toggle word wrap
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red Hat
Back to top