QEMU

There’s an experimental QEMU image available that includes:

  • phosh: phone graphical shell
  • Common apps: geary, ephiphany, contacts, calls
  • phone / network services: NetworkManager, ModemManager, ...

Linux Environments

  1. Open the Jenkins job building QEMU images on the CI server: https://arm01.puri.sm/job/Images/job/Image%20Build/

  2. Find the latest successful build which has the description qemu-x86_64 image, e.g. https://arm01.puri.sm/job/Images/job/Image%20Build/172/ . The number at the end of the URL is the build number, in this case 172.

  3. Download the build artifact called qemu-x86_64.img.xz. For the build numbered 172, it’s at the following URL:

    wget https://arm01.puri.sm/job/Images/job/Image%20Build/172/artifact/qemu-x86_64.img.xz
    
  4. Decompress it:

    unxz qemu-x86_64.img.xz
    
  5. Run it:

    qemu-system-x86_64 -boot menu=on -drive file=qemu-x86_64.img,format=raw -vga virtio -display sdl -m 1G -enable-kvm
    

    If you prefer a GUI:

  6. Use it

QEMU VM running phosh and default apps

Microsoft Windows

  1. Open the Jenkins job building QEMU images on the CI server: https://arm01.puri.sm/job/Images/job/Image%20Build/

  2. Find the latest successful build which has the description qemu-x86_64 image, e.g. https://arm01.puri.sm/job/Images/job/Image%20Build/172/

  3. Save the build by right-clicking on the file called qemu-x86-64.img and choosing “Save As”.

  4. Choose a folder on your computer with 4gb of free space.

  5. After the download is complete, extract the file with 7zip or other untar program.

  6. Open an instance of PowerShell and navigate to the extracted file’s folder.

  7. The following command can be executed in PowerShell after modifying the path to the qemu executable and the path to the downloaded qemu-x86-64.img file.:

    C:\Program Files\qemu\qemu-system-x86_64.exe -drive file=c:\downloads\qemu-x86_64.img,index=0,media=disk,format=raw -vga virtio -display sdl,gl=off -m 2G -L Bios -boot menu=on -rtc base=localtime,clock=host -parallel none -serial none -name PureOS -no-reboot
    
  1. Note: You may also download and modify the following PowerShell script for your environment. The file can executed on the command line, or by right-clicking launch-librem5.ps1 file from file explorer. The script is fully commented to explain the command line variables that are used.

PowerShell script: launch-librem5.ps1