VVV logo VVV

First make sure you have all the necessary software installed for VVV to run:

Vagrant Git

You will also need one of the following:

VirtualBox Parallels Business/Pro* Hyper-V

Windows users with Docker installed or Hyper-V turned on must use Hyper-V. Microsoft Hyper-V provides better performance and reliability.

* Parallels support is currently in beta, but is a viable option for Apple Silicon users. A Business or Pro license is required.

Reboot your computer after installing the above software.

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:

Mac/Linux: sh git clone -b stable https://github.com/Varying-Vagrant-Vagrants/VVV.git ~/vvv-local cd ~/vvv-local vagrant plugin install --local

Windows elevated/admin command prompt:

git clone -b stable https://github.com/Varying-Vagrant-Vagrants/VVV.git %systemdrive%%homepath%/vvv-local
cd %systemdrive%%homepath%/vvv-local
vagrant plugin install --local

Alternatively you can download a zip file from github but we strongly recommend against this, 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.

Starting VVV

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


cd ~/vvv-local
vagrant up

Windows elevated/admin command prompt:

cd %systemdrive%%homepath%/vvv-local
vagrant up

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:   ✧ ▄▀▀▀▄▄▄▄▄▄▄▀▀▀▄ ✧  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.