Configuring a virtualizer

The Vorteil CLI supports a number of hypervisors for running virtual machines on a local machine, without the need for any hypervisor-specific configuration, as long as at least one supported hypervisor is installed on the system.

Installing a supported hypervisor

QEMU

Supports Windows, Mac, and Linux, and has a fairly straightforward installation process. Installation instructions from qemu.org

Windows

Download links for Windows installers are listed on qemu.org

Mac

Brew: brew install qemu
MacPorts: sudo port install qemu

Linux

Arch: pacman -S qemu
Debian/Ubuntu: apt-get install qemu
Fedora: dnf install @virtualization
Gentoo: emerge --ask app-emulation/qemu
RHEL/CentOS: yum install qemu-kvm
SUSE: zypper install qemu

VMware Workstation and VMware Fusion

Supports Windows, Mac and Linux. Download links for the VMware Workstation can be found here and for VMware fusion can be found here. The Vorteil CLI uses the ‘vmrun’ binary, provided by either VMware Workstation or Fusion. An example can be seen below on how we can use the virtualizer.

    vorteil run helloworld --platform vmware

Hyper-V

Supports Windows only. Users must enable Hyper-V and must be a member of the Hyper-V administrator group (instructions here).

VirtualBox

Supports Windows, Mac, and Linux. Download links for the VirtualBox installers can be found here.

Firecracker

Supports Linux only. KVM must be installed on the local machine, and can be acquired through the use of a package manager. On Ubuntu, use the following command:

sudo apt-get install qemu-kvm

Firecracker must be downloaded and stored in the /usr/bin/ directory. Releases for the Firecracker binary can be found here. The following commands will download and install Firecracker:

wget https://github.com/firecracker-microvm/firecracker/releases/download/v0.22.0/firecracker-v0.22.0-x86_64
sudo mv firecracker-v0.22.0-x86_64 /usr/bin/firecracker
sudo chmod +x /usr/bin/firecracker

Any commands related to Firecracker must be run with sudo, due to the need to create bridge and tap devices when spawning a machine.

sudo ./vorteil run PACKAGE --platform firecracker