Guides Docker / Podmanĭue to the number of issues encountered around compatibility between the ruby runtime environment that is part of the upstream vagrant installation and the library dependencies of libvirt that this project requires to communicate with libvirt, there is a docker image built and published. In some cases the vagrant version for the distribution may be running with a sufficiently old ruby that it is difficult to install the required dependencies and you will need to use the upstream. If there is no distribution package or you wish to use the upstream vagrant, you may wish to use the our QA installation script to install both vagrant and vagrant-libvirt Alternatively you may follow vagrant installation instructions along with the manual instructions for what packages to install where indicated for upstream vagrant below. It should also work with earlier releases from 1.5 onwards but they are not actively tested.Ĭheck the unit tests for the current list of tested versions. Vagrant-libvirt supports Vagrant 2.0, 2.1 & 2.2. Next, you must have Vagrant installed from your distribution packages. Suggested packages are provided in our guides for as a quick referenceīefore you start using vagrant-libvirt, please make sure your Libvirt and QEMU installation is working correctly and you are able to create QEMU or KVM type virtual machines with virsh or virt-manager. For instructions, refer to your Linux distribution’s documentation.

Since upstream vagrant provides an embedded ruby, this typically causes issues with missing symbols between libraries included and what is expected by libvirt for the ruby bindings linking to work.įirst, you should have both QEMU and Libvirt installed if you plan to run VMs on your local system.

While we only test with upstream vagrant installed as a gem, we recommend that you install vagrant as provided by your distribution as installing vagrant-libvirt involves linking between libvirt (ruby-libvirt) and the ruby installation used by vagrant. GCC and Make - used to compile native versions of ruby-libvirt and nokogiri when using upstream Vagrant.Vagrant - plugin attempts to support all since 1.5.

Libvirt - should work with version 1.5 or newer.

Vagrant image