Skip to content

Latest commit

 

History

History
29 lines (21 loc) · 1.03 KB

README.md

File metadata and controls

29 lines (21 loc) · 1.03 KB

Vagrant Libvirt Example Box

Vagrant providers each require a custom provider-specific box format. This folder shows the example contents of a box for the libvirt provider. To turn this into a box create a Vagrant image according documentation (don't forget to install rsync command) and create box with following command:

$ tar cvzf custom_box.box ./metadata.json ./Vagrantfile ./box.img

This box works by using Vagrant's built-in Vagrantfile merging to setup defaults for Libvirt. These defaults can easily be overwritten by higher-level Vagrantfiles (such as project root Vagrantfiles).

Box Metadata

Libvirt box should define at least three data fields in metadata.json file.

  • provider - Provider name is libvirt.
  • format - Currently supported format is qcow2.
  • virtual_size - Virtual size of image in GBytes.

Converting Boxes

Instead of creating a box from scratch, you can use vagrant-mutate to take boxes created for other Vagrant providers and use them with vagrant-libvirt.