Go to the Image Build page on the CI server.

(The qcow2 image can also be built locally using Librem5 image building scripts .)

Find the most recent successful (green colored) qemu-x86_64 build in the Build History column on the left-hand side of the page (use the “find” field to filter the list in the column with “x86_64” as keyword for instance to match your target hardware architecture). Clicking on the link for that build will take you to a page containing a suitable qemu-x86_64.qcow2 image file.

Install the software required to run it:

You can use any virtualization application that will create a VM from a qcow2 to run this image.

GNOME Boxes On PureOS, gnome-boxes is already installed and can be used right away. Create a new Box from archive selecting qemu-x86_64.qcow2

Virt-manager On PureOS, you would need to install virt-manager:

$ sudo apt install virt-manager

Create a new virtual machine from your archive by selecting qemu-x86_64.qcow2

Command Line You can also run the qcow2 image from the command line:

$ sudo qemu-system-x86_64 -boot menu=on -drive file=qemu-x86_64.qcow2,format=qcow2 -vga virtio -display gtk -m 2G -enable-kvm

It may be necessary to pass the -smp option (for example with -smp 6 ) to improve performance. The -display option accepts different display types as its parameter – experimenting with these may prove useful.

If you would like to allow ssh connections from the host into the guest system, you may add -device e1000,netdev=net0 -netdev user,id=net0,hostfwd=tcp::5555-:22 to the qemu-system-x86_64 command above. Then, from another terminal window in the host, you can log in with this command:

$ ssh -p 5555 purism@localhost

See the QEMU documentation for more information.