table of contents
- bookworm 23.02.16+ds1-1
- bookworm-backports 23.06.22+ds1-2~bpo12+1
- testing 25.02.28+ds1-2
- unstable 25.04.04+ds1-1
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.
- gpu IDs
- Configure GPU for passthrough. The GPU IDs are e.g. 10de:1d01.
- gpu_unlock
- Re-attach/unlock all GPU’s to server (uninstall passthrough).
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
- •
- https://gitlab.com/soleil-data-treatment/soleil-software-projects/qemu-web-desktop
AUTHORS¶
Roland Mas.
April 2021 |