bootstrap-vz/bootstrapvz/providers/virtualbox
2016-09-12 19:11:20 +02:00
..
assets Fix installation of vbox guest additions. 2015-04-25 16:12:26 -03:00
tasks Systematically use rel_path for relative paths 2016-09-12 19:11:20 +02:00
__init__.py Systematically use rel_path for relative paths 2016-09-12 19:11:20 +02:00
manifest-schema.yml Fix guest additions path check in vbox schema 2015-12-09 17:23:35 +01:00
README.rst fix document toctree 2016-03-15 11:13:05 +09: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-block:: yaml

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