Free admin tools

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 sudo for 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?

  1. Follow the VMRelay installation instructions on your workstation, then run vmrelay.
  2. Press a and add your SSH destination, for example [email protected]. Verify the host’s SSH identity through your normal process.
  3. 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 sudo prompt.
  4. Press t to test SSH, libvirt, KVM, noVNC and websockify. Resolve failed checks before creating a guest.
  5. Press Enter on the host, then n to create a VM or i to import one. Open the VM with Enter and 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 t on 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=0 was 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.