bootstrap-vz/bootstrapvz/providers/virtualbox
2019-11-13 00:23:26 +01:00
..
assets Add comment-header to files deployed by bootstrap-vz (resolves #429) 2018-01-20 18:18:56 +01:00
tasks fix kernel options 2019-11-13 00:23:26 +01:00
__init__.py fix pylint W0403(relative-import) paths 2018-02-25 08:37:17 +00:00
manifest-schema.yml vbox: Make guest additions path relative to manifest 2017-07-14 18:27:16 +02: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