Contents

Requirements for Using Docker Machine & VirtualBox

  • Mac
  • Linux
  • Windows

VirtualBox

VirtualBox needs to be installed. It can be downloaded and installed with Nanobox.

vboxmanage in your $PATH

The vboxmanage binary needs to be included in your system $PATH. The VirtualBox installation process should do this automatically, but it some cases, it won't install correctly.

VT-x Enabled in Your BIOS

Virtualization must be enabled for your machine. This setting is found under ‘Advanced Chipset settings’ in BIOS and will be different for each motherboard. These days, most motherboards come with virtualization enabled by default, but it is disabled, you will need to enable it.

Requirements for netfs

If using the 'netfs' mount-type for filesystem mounting, you will need to make sure the nfsd executable is available and that the nfs server is running.

nfsd

The nfsd executable is used by OSX to manage the NFS (Network File System) server on your machine.

# Make sure nfsd is available. It ships with OSX,
# so unless you've deleted it, it should be available.
which nfsd
# check the status of your nfs server
nfsd status
# If disabled, enable and start the nfs server
nfsd enable
nfsd start

Install Virtual Box

If using the docker-machine provider, Nanobox utilizes Virtual Box to provision then Nanobox virtual environment on your local machine. If you already have it installed locally, you're all set. If not, Download & Install Virtual Box.

vboxmanage in your $PATH

The vboxmanage binary needs to be included in your system $PATH. The VirtualBox installation process should do this automatically, but it some cases, it won't install correctly.

VT-x Enabled in Your BIOS

Virtualization must be enabled for your machine. This setting is found under ‘Advanced Chipset settings’ in BIOS and will be different for each motherboard. These days, most motherboards come with virtualization enabled by default, but it is disabled, you will need to enable it.

Requirements for netfs

If using the 'netfs' mount-type for filesystem mounting, you will need to make sure the following requirements are met

nfs Installed & Running

nfs is used to manage the NFS (Network File System) on your local machine. It must be installed and the NFS server must be running in order for your local code to be mounted into the virtual machine.

Installing and running nfs depends on your Linux distribution. Your distribution documentation should provide instructions for installing the nfs package.

NFS Must Listen on Port 2049

2049 is the default port for the NFS server, but if it's set to something else, you will need to change it. The process of changing the NFS port depend on your Linux distribution.

exportfs Installed

exportfs maintains the table of exported directories for the nfs server. It must be installed in order for your local code to be mounted into the virtual machine. Installation instructions depend your Linux distribution.

VirtualBox

VirtualBox needs to be installed. It can be downloaded and installed with Nanobox.

vboxmanage in your $PATH

The vboxmanage binary needs to be included in your system $PATH. The VirtualBox installation process should do this automatically, but it some cases, it won't install correctly.

VT-x Enabled in Your BIOS

Virtualization must be enabled for your machine. This setting is found under ‘Advanced Chipset settings’ in BIOS and will be different for each motherboard. These days, most motherboards come with virtualization enabled by default, but it is disabled, you will need to enable it.

Important

If you're using docker-machine and switch to docker native, you won't be able to use VirtualBox again until Hyper-V is disabled.

Reach out to help@nanobox.io and we'll try to help.