Get started

Install VMBook and understand the first run

Use the window on a workstation or keep the background service running on a headless computer.

Install VMBook

Get the signed build from the download page. VMBook is free for personal, educational and commercial use. QEMU remains a separate program installed on the computer.

Protect important disks

Keep independent backups and test with copies. Conversion, repair and snapshot operations can change large files quickly.

Create or open a machine

  1. Choose the guest architecture and operating-system family.
  2. Assign memory, processors and disks.
  3. Review the QEMU command VMBook composes.
  4. Start it and open the screen or serial console.

VMBook-native machines have a stable ID and machine.json. Hyper-V, WSL and libvirt machines remain owned by their original platform.

Service mode

The keeper serves VMBook while its window is closed.

vmbook --service on
vmbook --service status
vmbook --service off

Linux uses a systemd user service. Windows starts it when that user signs in.

Settings

PlatformFolder
Windows%APPDATA%\com.vmbook.app\
Linux~/.config/com.vmbook.app/

API credentials, certificates, remotes and web users are administrative data. Protect this folder.