Installation

vrtmv is a single self-contained binary. It runs on Linux (x86-64) where your disk images or mounted sources live.

From a release build

Download the vrtmv binary for your platform, make it executable, and place it on your PATH:

chmod +x vrtmv
sudo mv vrtmv /usr/local/bin/
vrtmv --version

From source

The client is a standalone Rust crate. With a recent Rust toolchain (1.82+):

git clone <repository-url>
cd engine
cargo build --release
# binary at target/release/vrtmv (or $CARGO_TARGET_DIR/release/vrtmv)

What you need on the host

  • Nothing extra for --root (an already-mounted filesystem) or --ssh collection.
  • For --image (mounting a cold disk image), Vrtmv shells out to standard system tools and needs root plus:
    • losetup for raw images;
    • qemu-nbd and the nbd kernel module for qcow2/vmdk;
    • mount, and lvm tooling for LVM-backed roots.

The block-layer attach is always read-only, so the source image is never modified.

Next

Set up your account credentials in Authentication, then run the Quickstart.