VMs

HOW-TO

To start (or create) a VM, go in the desired folder and run

$ ./${OS}/run.sh [-b] [-s share] -- qemuopts
    -b: create and link a bridge device named as in /etc/qemu/bridge.conf
    -s: create a shared folder `share` between host and guest
        mount using `mount -t virtiofs "${SHARE}" /mnt`
every argument after -- is passed to qemu

You can pass qemu flags (see QEMU(1)) to ./run.sh directly or you can make theses flags permanent by editing run.sh (current VM only) or lib.sh (all VMs).

Headless

For a headless VM, just remove the -vga and -audio flags from lib.sh.
To start the VM in the background: ./run.sh & disown

CPU/RAM limit

By default, use all but 4 available threads. RAM limit is set to sane default in each run.sh and can be overridden with the $RAM variable.

RAM=8G ./run.sh

Port forwarding

To forward host port 2222 to guest port 22:

./run.sh -nic user,hostfwd=tcp::2222-:22

USB passthrough

If you need USB passthrough, uncomment and fill in the corresponding line in run.sh. You may need root privileges.

Windows

Installation

Shift+F10 to open cmd.exe or sendkey shift-f10 in Qemu shell

Warning

The drive letters might be different depending on how you mounted the drives!

E:
drvload amd64\${VERSION}\viostor.inf

diskpart
> sel disk 0

// MBR                             UEFI
> create par primary size=100   // create par efi size=100
> format fs=ntfs quick          // format fs=fat32 quick
> active                        //
> assign letter=Z

> create par primary
> format fs=ntfs quick
> assign letter=C
> exit

D:
cd sources
dism /get-imageinfo /imagefile:install.wim
dism /apply-image /imagefile:install.wim /index:2 /applydir:C:
dism /image:C:\ /add-driver /driver:E:\amd64\${VERSION}\viostor.inf
bcdboot C:\windows /s Z: /f [BIOS|UEFI]

Share prerequisites

• WinFsp
• Enable VirtIO-FS Service

See also

https://github.com/quickemu-project/quickemu