OpenVMM

OpenVMM can be configured to run as a conventional hosted, or "type-2" Virtual Machine Monitor (VMM).

At the moment, OpenVMM can be built and run on the following host platforms:

Host OSArchitectureVirtualization API
Windowsx64 / Aarch64WHP (Windows Hypervisor Platform)
Linuxx64KVM
x64MSHV (Microsoft Hypervisor)
macOSAarch64Hypervisor.framework

When compiled, OpenVMM consists of a single standalone openvmm / openvmm.exe executable.1

Note

As you explore the OpenVMM repo, you may find references to the term HvLite.

HvLite was the former codename for OpenVMM, so whenever you see the term "HvLite", you can treat it as synonymous to "OpenVMM".

We are actively migrating existing code and docs away from using the term "HvLite".

Notable Features

This non-exhaustive list provides a broad overview of some notable features, devices, and scenarios OpenVMM currently supports.

  • Boot modes
  • Devices
    • Paravirtualized
      • Virtio
        • virtio-fs
        • virtio-9p
        • virtio-serial
        • virtio-net
        • virtio-pmem
      • VMBus
        • storvsp
        • netvsp
        • serial
        • framebuffer
        • keyboard / mouse
        • vpci
    • Direct Assigned (experimental, WHP only)
    • Emulated
      • vTPM
      • NVMe
      • Serial UARTs (both 16550, and PL011)
      • Legacy x86
        • i440BX + PIIX4 chipset (PS/2 kbd/mouse, RTC, PIT, etc)
        • IDE HDD/Optical, Floppy
        • PCI
        • VGA graphics (experimental)
  • Device backends
    • Graphics / Mouse / Keyboard (VNC)
    • Serial (term, socket, tcp)
    • Storage (raw img, VHD/VHDx, Linux blockdev, HTTP)
    • Networking (various)
  • Management APIs (unstable)
    • CLI
    • Interactive console
    • gRPC
    • ttrpc

For more information on any / all of these features, see their corresponding pages under the Reference section of the OpenVMM Guide.

...though, as you may be able to tell by looking at the sidebar, that section of the Guide is currently under construction, and not all items have corresponding pages at this time.

Before heading on to Running OpenVMM, please take a moment to read and understand the following important disclaimer:

DISCLAIMER

In recent years, development efforts in the OpenVMM project have primarily focused on OpenHCL (AKA: OpenVMM as a paravisor).

As a result, not a lot of "polish" has gone into making the experience of running OpenVMM in traditional host contexts particularly "pleasant". This lack of polish manifests in several ways, including but not limited to:

  • Unorganized and minimally documented management interfaces (e.g: CLI, ttrpc/grpc)
  • Unoptimized device backend performance (e.g: for storage, networking, graphics)
  • Unexpectedly missing device features (e.g: legacy IDE drive, PS/2 mouse features)
  • No API or feature-set stability guarantees whatsoever.

At this time, OpenVMM on the host is not yet ready to run end-user workloads, and should should be treated more akin to a development platform for implementing new OpenVMM features, rather than a ready-to-deploy application.

1

though, depending on the platform and compiled-in feature-set, some additional DLLs and/or system libraries may need to be installed (notably: lxutil.dll on Windows).