Files
op-packages/qemu-vms
..
2026-08-01 23:48:21 +08:00

QEMU-VMS

VMS - Virtual Machine Simple

Simple manager qemu virtual machines

UCI configuration

All setting stored in /etc/config/qemu-vms

config vm — virtual machine instanse

Option Type Desc Default
enabled boolean Enable start 0
image string Image Disk path
cdrom string ISO-image path
memory integer RAM Size in MB 128
smp integer vCPU's 1
cpu* string CPU model host
machine* string Chipset machine type q35
disk_bus string Disk Bus virtio
display_type string Console type serial
vnc_port integer VNC-port if display_type=vnc
pci_passthrough list list pci devices passthrough
usb_passthrough list list usb devices passthrough
network list attached virtual network adapters -
custom_arg list Addional QEMU cmd args
Example
config vm 'router'
    option enabled '1'
    option image '/path/to/disk.img'
    option memory '512'
    option smp '2'
    option cpu 'host'
    option machine 'q35'
    option disk_bus 'virtio'
    option display_type 'serial'
    list network 'example_lan'
    list pci_passthrough 'pci_example'
    list usb_passthrough 'usb_example'
    list custom_arg '-drive if=floppy,file=/mnt/disk/vm/floppy_xp.img,format=raw'

config network — virtual machine network adapters

Option Type Desc Default
mac string adapter mac-address -
bridge string assign to bridge name -
ifname** string iface name in host -
driver string guest network adapter driver vfio-net-pci
Example
config network 'example_lan'
	option iface 'tap0'
	option bridge 'br-vm'
	option driver 'pcnet'

config pci_passthrough — Passthrough PCI devices

Option Type Desc
pci_id** string device BDF-addres
vendor_id string Vendor:Device ID
Example
config pci-passthrough 'pci_example'
    option pci_id '03:00.0'
    option vendor_id '8086 15f3'

config usb_passthrough — Passthrough USB devices

Option Type Desc
product_id** string Product device ID
vendor_id** string Vendor Device ID
Example
config usb_passthrough 'usb_example'
    option vendor_id '0bda'
    option product_id 'c811'

* - See help qemu for list all values **- Mandatory options

Usage init.d

  • /etc/init.d/qemu-vms start|stop|restart [vm_instance]