table of contents
- bookworm 23.02.16+ds1-1
- bookworm-backports 23.06.22+ds1-2~bpo12+1
- testing 24.01.19+ds1-3
- unstable 24.01.19+ds1-4
QWDCTL(1) | QWDCTL(1) |
NAME¶
qwdctl - Control qemu-web-desktop
SYNOPSIS¶
qwdctl keyword
DESCRIPTION¶
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.
Supported virtual machine formats are: ISO, QCOW2, VDI, VMDK, RAW, VHD/VHDX, QED
Each entry in the configuration file /etc/qemu-web-desktop/machines.conf spans on 3 lines:
- •
- [name.ext]
- •
- url=[URL to 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.
SUBCOMMANDS¶
- download
- Downloads virtual machine images referenced in the /etc/qemu-web-desktop/machines.conf file. A refresh is automatically launched afterwards.
- refresh
- 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/.
- status
- List the running sessions.
- stop TOKEN
- Stop sessions matching TOKEN. Some snapshot files may be left-over.
FILES¶
- •
- /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
AUTHORS¶
Roland Mas.
April 2021 |