Necessary artifacts

└── x86_64
    ├── lmp-factory-image-intel-corei7-64.wic.gz
    └── ovmf.qcow2

Booting in QEMU


These instructions require QEMU 5.2 or later.

  1. List available Targets and decide on which to boot:

    fioctl targets list


Make sure to set the FIOCTL_FACTORY environment variable:

export FIOCTL_FACTORY=<factory>

  1. Make a directory to store the artifacts and cd into it.

    mkdir -p lmp-qemu/x86_64
    cd lmp-qemu/x86_64
  2. Download the necessary artifacts for x86_64, replace <target_number> with the target you would like to boot

    # Download and extract the Factory image
    fioctl targets artifacts <target_number> intel-corei7-64/lmp-factory-image-intel-corei7-64.wic.gz | gunzip > lmp-factory-image-intel-corei7-64.wic
    # Download OVMF UEFI Firmware
    fioctl targets artifacts <target_number> intel-corei7-64/ovmf.qcow2 > ovmf.qcow2
  3. The directory tree should now look like this

    └── x86_64
        ├── lmp-factory-image-intel-corei7-64.wic
        └── ovmf.qcow2
  4. Run the QEMU script below against the artifacts inside of lmp-qemu/. You may want to save this as run.sh inside the directory for convenience

Booting Graphically

In order to boot QEMU with an OpenGL capable virtual GPU inside (required for Wayland/Weston), the following flags need to be added to the QEMU CLI:

-vga virtio -display gtk,gl=on

The -nographic flag must also be removed from the QEMU CLI.


qemu-system-x86_64 -m 1024 -cpu kvm64 -enable-kvm -serial mon:stdio -serial null \
  -drive file=lmp-factory-image-intel-corei7-64.wic,format=raw,if=none,id=hd \
  -device virtio-scsi-pci,id=scsi -device scsi-hd,drive=hd -device virtio-rng-pci \
  -drive if=pflash,format=qcow2,file=ovmf.qcow2 \
  -net user,hostfwd=tcp::22223-:22 -net nic -nographic



You can register your device following the steps from Register your device.