VirtualBox v4.0 and later installation

Please follow the screenshots to install CloVR with VirtualBox v4.0 or later. See Troubleshooting CloVR on VirtualBox for more help. Note: Users with an earlier version of Virtual Box – pre 4.0, either update to the most recent version of Virtualbox or see CloVR on VirtualBox pre-4.0

1) Click on ‘new’.

2) Click ‘Continue’.

3) Choose a Name for the VM (e.g. CloVR), select ‘Linux’ as Operating System and Version as ‘Ubuntu (64 bit)’.

4) Choose ‘2048’ MB of RAM as a minimum.

5) Select ‘Use existing hard disk’ and browse for the .vdi file (preferred) or .vmdk that is included with the download.

6) Check the summary screen and finish the installation with “Create”.

7) Set up networking:

Click on the VM and select “Settings” and then “Network”.

“Bridged Adapter” is preferred but may not work with wireless networking and some other networks. For further information, follow the link below.

8 ) Set up shared folders:
CloVR expects three shared folders that should be listed after clicking on the VirtualBox window and selecting “Settings” and then “Shared Folders”:

  • keys
  • user_data
  • vappio_conf

To add missing folders, click on the “Add Folder” icon (the upper icon with the green plus) and edit the “Folder Path” so that it matches the path on your computer to the “keys” folder in your CloVR VM. All shared folders are located in the same directory as the .vdi file. If you downloaded and set up CloVR from your Desktop, the path to your “keys” folder should look something like this:



Click “Auto-mount” and then “OK” when done. Repeat this for each shared folder. Repeat this procedure for the “user_data” and “vappio_conf” folders if necessary.

To edit the “Folder Path” so that it matches the path on your computer to the corresponding folder, click on the “Edit Folder” icon (the middle folder icon with the yellow dot).


9) To start CloVR, highlight the ‘CloVR’ VM in the VirtualBox window and click ‘start’ to boot CloVR into Virtual Box.


10) Check the terminal and desktop displays to make sure your CloVR VM launched correctly:

a) Networking: Change your Network settings (see above), if the terminal during the boot process reports “No external network access” or if the desktop display reports “Networking: No Address”.

b) Shared folders: Check your shared folders settings (see above), if the desktop display reports “Shared folders: Not OK”.

11) A fully functional CloVR VM console should look like the image posted underneath:

a) Node type: Should display as “master”.

b) Networking: Should display a “valid IP address”.

c) Shared folders: Should display as “OK”.

NOTE: Please wait for few minutes after you boot the CloVR image to see these values. It takes some time to update the status of the node to “master”, network to a “valid ip” and shared folders to “OK”.

The CloVR dashboard can be accessed by navigating a web-browser to the IP address listed under the Networking field.