bootstrap-vz/bootstrapvz/providers/virtualbox
2015-12-13 19:41:18 +01:00
..
assets Fix installation of vbox guest additions. 2015-04-25 16:12:26 -03:00
tasks Fix #104: Don't verify default target when adding packages 2015-04-29 23:51:55 +02:00
__init__.py Changes 'MoveImage' from loopback to image 2015-10-18 16:35:11 -02:00
manifest-schema.yml Fix guest additions path check in vbox schema 2015-12-09 17:23:35 +01:00
README.rst Improve providers docs and add loads of manifest examples 2015-12-13 19:41:18 +01:00

VirtualBox
----------

The `VirtualBox <https://www.virtualbox.org/>`__ provider can bootstrap
to both .vdi and .vmdk images (raw images are also supported but do not
run in VirtualBox). It's advisable to always use vmdk images for
interoperability (e.g.
`OVF <http://en.wikipedia.org/wiki/Open_Virtualization_Format>`__ files
*should* support vdi files, but since they have no identifier URL not
even VirtualBox itself can import them).

VirtualBox Guest Additions can be installed automatically if the ISO is
provided in the manifest.
VirtualBox Additions iso can be installed from main Debian repo by running:
`apt install virtualbox-guest-additions-iso`


Manifest settings
-----------------

Provider
~~~~~~~~

-  ``guest_additions``: Specifies the path to the VirtualBox Guest Additions ISO,
   which, when specified, will be mounted and used to install the
   VirtualBox Guest Additions.
   ``optional``

Example:

.. code:: yaml

    ---
    provider:
      name: virtualbox
      guest_additions: /usr/share/virtualbox/VBoxGuestAdditions.iso