@machinen/vmm-arm64-linux

Native arm64 VMM binary for Linux, shipped as an npm package so @machinen/cli can resolve it via optionalDependencies.

Built from the Zig source in packages/microvm; ships under bin/microvm. Uses KVM for hardware virtualization (host must have /dev/kvm accessible).

The package also ships a sibling bin/gvproxy — the gvisor-tap-vsock daemon that provides the user-mode network backend. @machinen/runtime auto-spawns it when present.

Install

Usually you don't install this directly — @machinen/cli pulls it in:

npm i -g @machinen/cli

If you're embedding @machinen/runtime without the CLI:

npm i @machinen/vmm-arm64-linux

The package's os/cpu gates will refuse installation on anything other than linux + arm64.

Usage

import { spawn } from "@machinen/runtime";
import { binary } from "@machinen/vmm-arm64-linux";

const vm = await boot({ binary, image: "./rootfs-debian-arm64.tar.gz", cmd: ["/bin/sh"] });

License

FSL-1.1-MIT — converts to MIT two years after each release.