Skip to main content

Supported OSes

Zarf is intended to install & run on a multitude of 64-bit Linux distributions.

Check the table below to understand which distros which we test against & if there are any known issues or usage caveats.

Support Matrix

OSVM_IDNotes
RHEL 7rhel7
RHEL 8rhel8
CentOS 7centos7
CentOS 8centos8
Ubuntu 20.04ubuntu
Debian 11debian
Rocky 8.4rocky

Demo Environments

We support running an instance of Zarf inside a local VM (of any of the supported OSes) for test & demonstration purposes.

Take note

Run the following commands from the project root directory.

Startup

To get a VM running, it's as easy as running a single command:

make vm-init OS=[VM_ID]     # e.g. make vm-init OS=ubuntu

Warning!

Besure to pass a VMID or you'll start a VM instance for _every one of the supported OS types. Yikes!

Work in the VM

To connect into the VM instance you just started, run:

vagrant ssh [VM_ID]         # e.g. vagrant ssh ubuntu

Once connected, you can work with your mounted-from-the-host copy of Zarf like so:

sudo su                     # escalate permissions (to "root" user)
cd /opt/zarf # access Zarf
./zarf help

When you're done with the VM, you can exit back to the host terminal by running:

exit                        # de-escalate permissions (back to "vagrant" user)
exit # exits VM shel & drops you back on the host

Shutdown

Closing out the demo environment is also a single command:

make vm-destroy

This will shutdown & destroy all the demo VM instances it can find. Easy-peasynice and clean.