Tested against

• Host: Mac OS X 10.11.4, Ubuntu 14.04 LTS
• Virtualization Providers: VirtualBox 5.0.16, VMware Fusion 7.1.3
• Packer^ ~> 0.10.0
• Vagrant ~> 1.8.1

(^) Packer is required to build the custom Ubuntu image.

Installation

Define your Base Box

cp packer/template.json.example packer/template.json

Note: packer/template.json.example is based on Packer 0.10.0.

Default hardware settings (adjust variables as necessary)

• cpu_cores: 4 cores
• memory: 4096 MB
• disk_size: 20140 MB

Vagrantfile

• Copy Vagrantfile.example as Vagrantfile or create your own.
• Configure and uncomment recipes that you want to cook.
• Optionally create your own recipes and place in the cookbooks/custom directory

One click install command

rake virtualbox:install
rake vmware:install

The basic vagrant commands

  vagrant up      # starts vagrant
  vagrant ssh     # SSH into vagrant
  vagrant reload  # restarts vagrant
  vagrant halt    # stops vagrant

Gotchas

1. If your vm cannot connect to the internet (this typically happens when you switch from one network to another on a VirtualBox vm), run this command:

sudo dhclient

2. You received the message: "Error creating VM: VBoxManage error: VBoxManage: error: Machine settings file <path_to_vbox> already exists". Installation was left in a bad state. Open VirtualBox, stop and remove the existing VM. Delete this vbox in your VirtualBox directory and re-run the command that failed.

3. On VMware, if HGFS kernel module could not be found, you'll need to re-install VMwareTools. Follow the instructions in the README.

4. You received the message: "Shared folders that Chef requires are missing on the virtual machine. This is usually due to configuration changing after already booting the machine. The fix is to run a vagrant reload so that the proper shared folders will be prepared and mounted on the VM." Read the workaround solution here.