Setting up a Virtual Machine

Setup with QEMU/KVM Tools

The images generated are compressed raw disk images. They can be utilized both on physical devices and used as disks on a virtualization platform. The images work without change on QEMU/KVM.

On QEMU/KVM the tools that can be used to run the image in a VM include Virtual Machine Manager or virsh command line utility. These tools are available in most Linux distributions.

Decompress the image as below and then create a new virtual machine.

$ xz -d Fedora-IoT-[version].raw.xz

When asked for an installation source or storage location, point the tool at the existing disk image.

virt-manager create new dialog

When your image begins booting, continue with the Initial Setup instructions.

To learn more about the libvirt family of tools used in Fedora, visit the Getting started with virtualization section of the Fedora Documentation.

QEMU (on Linux hosts only) also supports user mode emulation. In this mode, QEMU can launch Linux processes compiled for one CPU on another CPU. Learn more in the How to use QEMU section of the Fedora Documentation.

Setup with GNOME Boxes

While GNOME Boxes is based on libvirt, it does not support all of the features and it does not recognize the raw image format. The images we produce need to be converted to to a QCOW2 format. This can be done with the qemu-img command found in the qemu-img package.

Decompress and convert the image as below and then create a new virtual machine.

$ xz -d Fedora-IoT-[version].raw.xz
$ qemu-img convert -f raw Fedora-IoT-[version].raw -O qcow2 Fedora-IoT-[version].qcow2

When asked for an installation source or storage location, point the tool at the existing disk image.

GNOME Boxes create new dialog

When your image begins booting, continue with the Initial Setup instructions.

Alternately, you can install a new box from the ISO image.

More information on using GNOME Boxes can be found in the GNOME HELP pages.

Setup with VirtualBox

The images we produce need to be converted to be used with VirtualBox. This can be done with the qemu-img command found in the qemu-img package.

Decompress and convert the image as below and then create a new virtual machine.

$ xz -d Fedora-IoT-[version].raw.xz
$ qemu-img convert -f raw Fedora-IoT-[version].raw -O vdi Fedora-IoT-[version].vdi

When asked for an installation source or storage location, point the tool at the existing disk image.

VirtualBox create new hard disk dialog

When your image begins booting, continue with the Initial Setup instructions.

More information for using Virtual Box can be found at VirtualBox.org