DOKK / manpages / debian 12 / qemu-web-desktop / qwdctl.1.en
QWDCTL(1) QWDCTL(1)

qwdctl - Control qemu-web-desktop

qwdctl keyword

qwdctl is a simple script that downloads virtual machine images for use with qemu-web-desktop and/or refreshes the list of available images so that qemu-web-desktop can display it in its web interface.

Each entry in the configuration file /etc/qemu-web-desktop/machines.conf spans on 3 lines:

[name.ext]
url=[URL to ISO, QCOW2, VDI, VMDK, RAW virtual machine disk, optional]
description=[description to be shown in the service page]

Images listed in the configuration file without a url= parameter are expected to be downloaded by hand and installed into /var/lib/qemu-web-desktop/machines by the local administrator. Then, just specify the [name.ext] and description.

Downloads virtual machine images referenced in the /etc/qemu-web-desktop/machines.conf file. A refresh is automatically launched afterwards.
Regenerates the list of available images based on the /etc/qemu-web-desktop/machines.conf file. The generated file is e.g. /var/lib/qemu-web-desktop/machines.html which should be linked into /usr/share/qemu-web-desktop/html/desktop/.

/etc/qemu-web-desktop/machines.conf
/var/lib/qemu-web-desktop/machines.html
/var/lib/qemu-web-desktop/machines
/usr/share/qemu-web-desktop/html/desktop

Roland Mas.

April 2021