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 / usage caveats.
| OS | VM_ID | Notes |
|---|---|---|
| RHEL 7 | rhel7 | |
| RHEL 8 | rhel8 | |
| CentOS 7 | centos7 | |
| CentOS 8 | centos8 | |
| Ubuntu 20.04 | ubuntu | |
| Debian 11 | debian | |
| Rocky 8.4 | rocky |
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.
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=ubuntuWarning!
Besure to pass a VM_ID or you'll start a VM instance for every one of the supported OS types. Yikes!
To connect into the VM instance you just started, run:
vagrant ssh [VM_ID] # e.g. vagrant ssh ubuntuOnce 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 helpWhen 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
Closing out the demo environment is also a single command:
make vm-destroyThis will shutdown & destroy all the demo VM instances it can find. Easy-peasy—nice and clean.