VVV logo VVV

There are 3 steps to getting VVV running:

  1. Install pre-requisite tools/software
  2. Install VVV
  3. Start VVV from the command line/terminal then visit the dashboard

1. Install Pre-requisite software

Before you can install VVV you need to install these two tools if they aren’t already installed:

Vagrant Git

You also need to choose a provider to host the server, this could be VirtualBox/Docker/Parallels/etc, use the tabs below to choose a provider. Most of the time VirtualBox is best unless you use a Mac.

Reboot your computer after installing the above software.

2. Installing VVV

We’re going to install VVV to a vvv-local folder in your home directory. First, grab a copy of VVV using git. Open a terminal or a command prompt, and enter the following command:

Alternatively you can download a zip file from github but we strongly recommend against this though, as it makes updating VVV much harder. If you did this, skip the first commmand.

At this point you might want to adjust the config/config.yml file before VVV creates the local developer environment. This is your opportunity to do so. You might do this in order to change the provider vagrant uses to Hyper-V instead of VirtualBox, or to provision additional sites the first time the VM is created to save time.

3. Starting VVV

Start VVV by opening a terminal, changing to the VVV folder, and running vagrant up. For example:

The first time you run vagrant up may take longer while it installs PHP and other tools. When finished it will show a teddy bear and a VVV logo that look like this:

    default:
    default:   ✧ ▄▀▀▀▄▄▄▄▄▄▄▀▀▀▄ ✧  Thanks for  __ __ __ __
    default:    ✧█▒▒░░░░░░░░░▒▒█    using       \ V\ V\ V /
    default:  ✧   █░░█░░░░░█░░█ ✧                \_/\_/\_/
    default:   ▄▄  █░░░▀█▀░░░█  ▄▄✧
    default:  █░░█ ▀▄░░░░░░░▄▀ █░░█ Vagrant Up has finished! Visit http://vvv.test
    default: ──────────────────────────────────────────────────────────────────────

You will find a dashboard at http://vvv.test, and your websites will be in the www subfolder.