Manage Remote KVM VMs from macOS or Linux
Use VMRelay on your Mac or Linux workstation to manage KVM virtual machines on an Ubuntu or Debian server over SSH. The VMs run on the server, while you use a terminal interface and a browser console on your workstation. There is no need to replace the host OS with Proxmox.
Standalone tools. Apache licensed and free for commercial use. No SimpleHelp licence required.
What do I need?
- A macOS or Linux workstation with SSH and a web browser. VMRelay packages are available for Intel/AMD and ARM workstations.
- An Ubuntu or Debian host with KVM hardware virtualisation support, enough capacity for your guests and an SSH account that can use
sudofor setup. - Access to the host’s configured SSH port. Host setup also needs access to the distribution package repositories. You do not need to open public VNC, noVNC or libvirt ports.
On an Apple silicon Mac, an x86-64 Linux host lets you work with x86-64 guests remotely. The host does the virtualisation; VMRelay is not translating x86 guests on your Mac. Choose guest media for the host architecture.
How do I connect my workstation to the host?
- Follow the VMRelay installation instructions on your workstation, then run
vmrelay. - Press
aand add your SSH destination, for example[email protected]. Verify the host’s SSH identity through your normal process. - Choose setup after saving the host. It installs KVM/libvirt, the console dependencies and firmware, and prepares the default NAT network and image pool. Approve the host’s normal
sudoprompt. - Press
tto test SSH, libvirt, KVM, noVNC and websockify. Resolve failed checks before creating a guest. - Press
Enteron the host, thennto create a VM orito import one. Open the VM withEnterand choose Open browser console from its actions.
Expected result: you can see and operate the guest’s console in your local browser. The VM continues to run on the Linux host.
How does console access work without a public web port?
VMRelay starts a noVNC console listener on the host’s loopback interface and reaches it through an SSH tunnel. Your browser uses the local end of that tunnel. This avoids publishing the console service on the host’s public network interfaces.
The guest uses the libvirt network you select. The default is NAT, which permits outbound connections; a private console does not make the guest network isolated. VMRelay’s private/shared labels are interface metadata, not an access boundary against host administrators.
What if the connection or console fails?
- Test ordinary SSH to the same destination first. Resolve authentication, host-key and firewall failures before testing the VM stack.
- Use
ton the host to identify missing KVM or console dependencies. If the host is itself a VM, hardware virtualisation may need to be exposed by its provider. - If the browser does not open automatically, check whether
VMRELAY_OPEN_BROWSER=0was set. Console access still depends on a working SSH tunnel. - Press
?for the controls available in the current VMRelay view.
Your questions, answered
Is this a virt-manager alternative for a Mac?
VMRelay offers a terminal workflow for supported remote KVM tasks from macOS or Linux. It uses system libvirt on the host and does not claim to replace every virt-manager feature.
Must I install Proxmox or replace Ubuntu?
No. VMRelay prepares the KVM/libvirt stack on an existing Ubuntu or Debian host. Review the setup changes before using a host that already runs other workloads.
Related guides and tools
Run Windows 11 Test VMs on a Linux Server over SSH
Create Windows 11 test VMs on a remote Linux server with VMRelay. Configure UEFI, Secure Boot and TPM 2.0, then test installers through an SSH browser console.
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