Virtum runs virtual machines and multi-VM labs on your Linux machine, with a Docker-like experience. One command for a VM, one YAML file for a lab. KVM and libvirt underneath.
HOW IT WORKS
01 · DESCRIBE
Virtumfile
name: demo-lab
machines:
web:
os: debian-12
db:
os: ubuntu-24.0402 · PREVIEW
virtum plan
Machines : + create db + create web # without touching anything
03 · CREATE
virtum up
isolated lab network · virtum-lab-demo-lab
04 · ROLL BACK
virtum snapshot
create before-test # a test breaks db restore before-test # back to a known state
FEATURES
Several machines on an isolated network. plan shows what changes, apply applies it, machines are created in parallel.
Declared subnets and fixed addresses, ports forwarded locally, VMs directly on the local network in bridge mode.
virtiofs shares, read-only by default. Write access is declared with :rw.
The playbook runs on the first up, and the inventory is generated with each VM's SSH keys.
Freeze a VM or a whole lab before a risky test, then roll back in one command.
Debian 12, Ubuntu 24.04 and 26.04: official cloud images, verified by checksum.
SECURE BY DEFAULT
The threat model, guarantees and limits are written down, and each guarantee is tied to the code that enforces it.
Read the security policy →Enforced on the host. A writable share cannot contain the Virtumfile or the Ansible files.
Another VM that gets a VM's address presents a different key: the connection is refused.
The playbook runs from a private copy of its folder, without the writable shares.
SHA-256 checksums and a provenance attestation: the downloaded file really comes from the repository's CI.
REAL-WORLD EXAMPLES
name: preprod
ansible:
playbook: ansible/site.yml
machines:
web: { os: ubuntu-24.04, groups: [front] }
db: { os: ubuntu-24.04, groups: [data] }
$ virtum up # creates, provisions, takes the "provisioned" snapshot
$ virtum provision # runs the updated playbook again
$ virtum snapshot restore provisionedThe playbook runs from a private copy of its folder; the "provisioned" snapshot brings the whole lab back to the provisioned state.
Linux x86_64 with KVM. Validated end to end on Ubuntu 24.04; the package also installs on Ubuntu 22.04 and Debian 12, without shared folders.
Only to install it and prepare the host. After that, Virtum runs under your own account, as a member of the libvirt and kvm groups.
Yes, and open source under the Apache-2.0 license, including for commercial use.
By email to security@virtum.dev, or through a private report on GitHub.
sudo apt install ./virtum_1.1.0_amd64.deb