Skip to content
v1.1.0 — .deb package available

VMs,
made simple.

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.

Apache-2.0 · Linux x86_64 · Rust

~/projects/demo

HOW IT WORKS

One file describes the lab. Virtum creates it, shows it, restores it.

  1. 01 · DESCRIBE

    Virtumfile

    name: demo-lab
    machines:
      web:
        os: debian-12
      db:
        os: ubuntu-24.04
  2. 02 · PREVIEW

    virtum plan

    Machines :
      + create    db
      + create    web
    # without touching anything
  3. 03 · CREATE

    virtum up

    isolated lab network · virtum-lab-demo-lab

    web
    db
  4. 04 · ROLL BACK

    virtum snapshot

    create before-test
    # a test breaks db
    restore before-test
    # back to a known state

FEATURES

Everything a lab needs, nothing more.

Labs in one file

Several machines on an isolated network. plan shows what changes, apply applies it, machines are created in parallel.

Networking and bridge

Declared subnets and fixed addresses, ports forwarded locally, VMs directly on the local network in bridge mode.

Shared folders

virtiofs shares, read-only by default. Write access is declared with :rw.

Built-in Ansible

The playbook runs on the first up, and the inventory is generated with each VM's SSH keys.

Snapshots

Freeze a VM or a whole lab before a risky test, then roll back in one command.

Official images

Debian 12, Ubuntu 24.04 and 26.04: official cloud images, verified by checksum.

SECURE BY DEFAULT

The guest is treated as an adversary.

The threat model, guarantees and limits are written down, and each guarantee is tied to the code that enforces it.

Read the security policy →

Read-only shares

Enforced on the host. A writable share cannot contain the Virtumfile or the Ansible files.

SSH key pinned per VM

Another VM that gets a VM's address presents a different key: the connection is refused.

Isolated Ansible

The playbook runs from a private copy of its folder, without the writable shares.

Verifiable binaries

SHA-256 checksums and a provenance attestation: the downloaded file really comes from the repository's CI.

REAL-WORLD EXAMPLES

What people do with Virtum, command by command.

VirtumfileAnsible + snapshots
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 provisioned

The playbook runs from a private copy of its folder; the "provisioned" snapshot brings the whole lab back to the provisioned state.

Frequently asked questions

Which systems does Virtum run on?

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.

Does it need administrator rights?

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.

Is Virtum free?

Yes, and open source under the Apache-2.0 license, including for commercial use.

How do I report a vulnerability?

By email to security@virtum.dev, or through a private report on GitHub.

Your first lab in a few minutes.

sudo apt install ./virtum_1.1.0_amd64.deb

Download