Get started

Computers, providers, machines and images

A consistent vocabulary keeps native QEMU and externally owned machines understandable.

Computer

A computer is a host running VMBook. It reports identity, operating system, architecture, capacity and available providers.

Provider

A provider owns or presents machines. VMBook owns native QEMU definitions. Hyper-V, WSL and libvirt remain authoritative for their machines; VMBook sends supported actions back instead of duplicating configuration.

Machine

A machine has an ID, name, group, state, architecture, firmware and resources. Native IDs begin with m-; libvirt IDs with lv-. Names may collide, so automation should retain the ID.

Image

An image is a disk object that can be inspected, converted, resized, compacted, checked, repaired or attached. It is not the machine identity.

Site

Sites group computers into offices, labs and data centers. Only endpoints listed under API reference belong to the current public v1 contract.