Virtual Machine Deployment

Getting Started

The One-KVM VM bundle is a preinstalled virtual disk with One-KVM. Create a VM from this disk and pass through the USB devices to use One-KVM. This guide demonstrates VMware; VirtualBox is similar.

Required software: VMware or VirtualBox

Required peripherals: USB HDMI capture card, CH340+CH9329 USB combo cable

Minimum VM: 1 vCPU, 512 MB RAM

VMware

Create a VM

Extract the disk first. In VMware Workstation Pro, File -> New Virtual Machine, choose Custom (Advanced), Next. Keep default compatibility, Next.

Choose "I will install the operating system later". Guest OS: Linux. Next. Name the VM and choose a location. Next.

Choose CPU and memory as needed (min 1/512 MB). Network: choose as needed; Bridged is recommended. Keep default I/O controller and virtual disk type.

Select "Use an existing virtual disk". Choose the extracted disk. Keep the disk format. Finish (do not start yet).

Edit settings

In the VM home, Edit virtual machine settings. Set USB Controller -> USB compatibility to USB 3.1. In Options -> Advanced, set Firmware type to UEFI. Optionally enable "Disable side-channel mitigations for Hyper-V hosts" to reduce overhead.

Start the VM

Plug the USB HDMI capture card and CH340+CH9329 combo cable into the host. Start the VM and pass these two USB devices through to the VM.

Usage

Visit the VM IP in a browser. On first visit, trust the self-signed certificate. Default credentials: admin/admin.

Others

If the VM in bridged mode gets no IP, the auto-bridging may have chosen the wrong NIC. Fix it in the Virtual Network Editor.