Varying Vagrant Vagrants logo Varying Vagrant Vagrants

VVV requires recent versions of both Vagrant and VirtualBox to be installed, along with some vagrant plugins.

  1. Start with any local operating system such as Mac OS X, Linux, or Windows.
    • For Windows 8 or higher it is recommended that you run the cmd window as Administrator.
  2. Install VirtualBox 5.x Note, currently 5.2.x fails on Ubuntu, use 5.1.x
  3. Install Vagrant 2.x
    • Vagrant is a “tool for building and distributing development environments”. It works with virtualization software such as VirtualBox to provide a virtual machine sandboxed from your local environment.
    • vagrant will now be available as a command in your terminal, try it out.
    • Provider support is included for VirtualBox, Parallels, Hyper-V, VMWare Fusion, and VMWare Workstation.
    • Note: If Vagrant is already installed, use vagrant -v to check the version. You may want to consider upgrading if a much older version is in use.
  4. Install some these Vagrant plugins:
    1. Install the vagrant-hostsupdater plugin with vagrant plugin install vagrant-hostsupdater
      • Note: This step is not a requirement, though it does make the process of starting up a virtual machine nicer by automating the entries needed in your local machine’s hosts file to access the provisioned VVV domains in your browser.
      • If you choose not to install this plugin, a manual entry should be added to your local hosts file that looks like this: vvv.test local.wordpress.test src.wordpress-develop.test build.wordpress-develop.test
    2. Install the vagrant-triggers plugin with vagrant plugin install vagrant-triggers
      • Note: This step is not a requirement. When installed, it allows for various scripts to fire when issuing commands such as vagrant halt and vagrant destroy.
      • By default, if vagrant-triggers is installed, a db_backup script will run on halt, suspend, and destroy that backs up each database to a dbname.sql file in the {vvv}/database/backups/ directory. These will then be imported automatically if starting from scratch. Custom scripts can be added to override this default behavior.
      • If vagrant-triggers is not installed, VVV will not provide automated database backups.
    3. Install the vagrant-vbguest plugin with vagrant plugin install vagrant-vbguest.
      • Note: This step is not a requirement. When installed, it keeps the VirtualBox Guest Additions kernel modules of your guest synchronized with the version of your host whenever you do vagrant up. This can prevent some subtle shared folder errors.

Windows Users

You may need to turn on virtualization in your computers BIOS, some computers come with it turned off by default. Refer to your machines manufacturer for how to access your BIOS.