Skip to content

First VM ​

One command starts a VM:

bash
virtum run --os debian-12 --name web

The first use of an OS downloads its official cloud image; later runs start from the cache. To download an image ahead of time:

bash
virtum pull ubuntu-24.04

Available images: debian-12 (default), ubuntu-24.04, ubuntu-26.04.

Choose the resources ​

bash
virtum run --os ubuntu-24.04 --ram 4096 --cpu 2 --disk-size 20G
OptionPurposeDefault
--osOS imagedebian-12
--nameShort, unique name used by the other commands—
--ramMemory in megabytes2048
--cpuNumber of virtual CPUs2
--disk-sizeDisk size (10G, 20G…)image size
--userDefault login user (cloud-init)virtum
--hostnameGuest hostname--name, else the vm-… id
--networkdefault (libvirt NAT) or bridge (local network)default

Disks are copy-on-write on top of the base image. All options: Commands.

Use the VM ​

bash
virtum ps                     # running VMs and their IP; -a for all
virtum shell web              # SSH session
virtum stop web               # graceful shutdown, forced after 30 s
virtum start web              # starts the same instance again
virtum destroy web            # deletes the VM and its local data

Commands take the VM's name (--name) or its vm-… id. stop, start and destroy take several.

Next ​

For several machines on an isolated network, describe them in a Virtumfile: First lab.