Run Windows 11 Test VMs on a Linux Server over SSH
Use a remote Linux host for Windows 11 installer and application testing while keeping your workstation free for development. VMRelay creates KVM guests with UEFI, Secure Boot and a software TPM, and opens their consoles through SSH. Supply your own Windows media and licence.
Standalone tools. Apache licensed and free for commercial use. No SimpleHelp licence required.
What should I prepare?
- A supported VMRelay workstation and an x86-64 Ubuntu or Debian host with KVM, connected and tested using the remote KVM setup guide.
- A Windows 11 x64 installation ISO accessible on the Linux host, plus the appropriate Windows licence.
- A compatible host processor and guest configuration meeting Windows requirements, including at least two CPU cores, 4 GB RAM and 64 GB storage. Leave capacity for updates and the software you will test.
UEFI, Secure Boot and TPM options address firmware requirements. They do not by themselves guarantee that every Windows release, application or hardware requirement is satisfied.
How do I create and install the Windows guest?
- Open the tested host in
vmrelayand pressnto create a VM. - Choose a descriptive test-machine name and allocate CPU, memory and disk space for the intended workload.
- Choose UEFI firmware. VMRelay’s UEFI creation path includes Secure Boot and TPM 2.0. Select your Windows ISO using the host file browser.
- Use the default NAT network unless your test needs a separately reviewed network configuration. Create the VM and open its details.
- Start the VM from its actions if it is not running, then choose Open browser console. Complete Windows installation in the console.
- In Windows, check
msinfo32for UEFI and Secure Boot state, andtpm.mscfor TPM specification version 2.0. Check networking and Windows activation before testing your software.
Expected result: a working Windows test desktop hosted on Linux and accessible from your workstation’s browser over an SSH tunnel.
How can the guest reach a development server on my laptop?
VMRelay service mappings forward a guest-facing bridge port to a service bound to your workstation’s loopback address. For example, a development web server on 127.0.0.1:8000 can be reached through a mapping with local service port 8000 and VM port 18000.
- Start a test-only service on your workstation. Do not map a production administration endpoint.
- In the host’s Mappings tab, add a mapping with those two ports and start it.
- Open the VM endpoint shown by VMRelay from the guest. On the default bridge this is normally
http://192.168.122.1:18000. Use the displayed address if your host differs. - Stop the mapping when the test finishes. Other guests on that bridge may also reach its listener.
Keep the direction clear: this mapping lets the guest reach your workstation. It is not a general-purpose public port forward into the Windows guest.
What should I check when a test fails?
- If Windows setup rejects the machine, check the CPU and resource requirements as well as the UEFI and TPM selection.
- If the console fails, retest the host’s SSH and noVNC dependencies before changing guest settings.
- If a mapped web service fails, confirm it is running locally, the mapping is started, and the guest is using the displayed bridge address rather than its own
localhost. - Keep a clean test baseline and avoid production credentials or data. NAT does not prevent guest access to reachable internal networks.
Your questions, answered
Can I use an Apple silicon Mac as the workstation?
Yes. The Mac runs VMRelay and the browser, while the x86-64 Linux host runs the Windows x64 guest. VMRelay does not run that guest locally on the Mac.
Does VMRelay include a Windows licence?
No. You supply installation media and licensing. Validate guest requirements and activation for the Windows version you install.
Related guides and tools
Manage Remote KVM VMs from macOS or Linux
Manage KVM virtual machines on an existing Ubuntu or Debian server from macOS or Linux. Use VMRelay over SSH, with browser consoles and no web admin port.
Read guideImport VirtualBox and VMware VMs into KVM
Move VirtualBox and VMware test VMs to KVM with VMRelay. Import VBOX, VMX, VDI or VMDK files, convert disks to qcow2 and check boot, drivers and networking.
Read guideRun AI Agents in Disposable Ubuntu VMs
Use VMRelay and agent-sudo to run trusted AI agents in disposable Ubuntu VMs. Keep root grants in the guest and review network access, data and cleanup.
Read guideVMRelay documentation and downloads · agent-sudo documentation and downloads