Free tools

VMRelay: Run VMs on a Remote Linux Host from Your Terminal

Apache licensed and free for commercial use.

VMRelay is a free terminal app for creating, importing and managing KVM virtual machines on an ordinary Ubuntu or Debian server, over SSH. Open VM consoles in your browser without exposing VNC or libvirt to the network.

Test machines on a server you already have

Sometimes you just need a few virtual machines: a Windows build to test an installer, an old server image to reproduce a fault, or a clean Linux machine to try a configuration change. A full virtualisation platform can be more than that job needs, and a web-based hypervisor console is one more service to secure.

VMRelay works through the SSH access you already have. It prepares the host, then lets you create, import and run VMs from a keyboard-driven terminal interface on your own workstation.

The VMRelay terminal app listing seven Windows virtual machines on a host, with their state, owner and visibility.
The VMRelay host view, listing each VM with its state, owner and visibility.

What VMRelay does

Set up a host in one step

On Ubuntu or Debian, setup installs QEMU/KVM, libvirt, UEFI firmware, a software TPM, noVNC and websockify. It also starts the libvirt default NAT network and creates a VMRelay image pool.

Create VMs with Windows-friendly defaults

New VMs use qcow2 disks, NAT networking, an e1000e network adapter and USB tablet input. Choose BIOS or UEFI, with Secure Boot and TPM 2.0 when you select UEFI. Browse ISO files on the host from the create wizard.

Import existing VMs

Import VirtualBox .vbox and VMware .vmx machines, or .vdi and .vmdk disks. VMRelay copies and converts disks to qcow2 and leaves the source files untouched.

Open consoles in your browser

Each console runs through noVNC on the host's loopback interface, reached through an SSH tunnel from your workstation. Nothing is published on the host's public interfaces.

Let guests reach your workstation

Service mappings forward a port on the VM-facing libvirt bridge back to a service on your workstation, such as a development web server, through a reverse SSH tunnel.

Manage disks, networks and resources

Create, import, convert and detach disks, set boot priority, attach network adapters and change CPU and memory. Mark VMs as private or shared with other VMRelay users on the host.

Install VMRelay

You need:

  • A macOS or Linux workstation (Intel/AMD or ARM) with an OpenSSH client and a web browser.
  • An Ubuntu or Debian host with hardware virtualisation support, reachable over SSH.
  • An account on the host that can use sudo, to run setup.

Run this on your workstation:

curl -fsSL https://tools.simplehelp.io/vmrelay/install.sh | bash

The installer downloads the package for your platform from tools.simplehelp.io, verifies its pinned SHA-256 checksum and installs vmrelay to /usr/local/bin, asking for sudo if it needs to. Set VMRELAY_INSTALL_DIR to install somewhere else. For manual installation, download a package and the matching checksums below.

VMRelay 0.2.53 downloads:

VMRelay checks for new releases when it starts. Updates and host setup leave the terminal app first, so sudo prompts work normally.

Get started

  1. Run vmrelay.
  2. Press a to add a host, for example [email protected].
  3. Choose whether to run setup once the host is saved.
  4. Press t to test SSH, libvirt, KVM, noVNC and websockify on the host.
  5. Press Enter to open the host.
  6. Press n to create a VM, or i to import one.
  7. Press Enter on a VM for its Summary, Disks, NICs and Actions.

Press ? at any time for help, and m to change the colour theme. To stop VMRelay opening your browser automatically, run VMRELAY_OPEN_BROWSER=0 vmrelay.

Security model

VMRelay manages the host over SSH and does not expose libvirt, noVNC or websockify on the public network. Console listeners bind only to loopback and are reached through SSH local forwards. Service mappings expose a relay only on the libvirt bridge that guests use, not on the host's public interfaces.

VMs run under system libvirt at qemu:///system. Private and shared visibility is VMRelay metadata for its own interface. It is not a security boundary for users who also have broad sudo or libvirt access on the host.

Your questions, answered

Is VMRelay free?

Yes. VMRelay is Apache licensed and free for commercial use, and its source code is published on GitHub.

Do I need SimpleHelp to use VMRelay?

No. VMRelay is a standalone tool and does not need a SimpleHelp server or licence.

Which hosts does VMRelay support?

VMRelay sets up and manages Ubuntu and Debian hosts with KVM hardware virtualisation, over SSH. Setup needs an account that can use sudo.

Can VMRelay run Windows 11 virtual machines?

VMRelay can create UEFI virtual machines with Secure Boot and TPM 2.0, which Windows 11 requires. You supply your own Windows installation media and licence.

Can I import VMs from VirtualBox or VMware?

Yes. VMRelay imports .vbox and .vmx machines and .vdi and .vmdk disks, converts the disks to qcow2 and leaves the original files untouched.

Are VM consoles exposed to the internet?

No. Consoles listen only on the host's loopback interface and are reached through an SSH tunnel from your workstation.

Test on VMs. Support the real machines too.

SimpleHelp gives you remote support, access, monitoring and automation for Windows, macOS and Linux, on a server you control. Every feature, free for 30 days.

Start Free Trial