VVV logo VVV

Turning VVV On

Change into the VVV folder and run:

vagrant up

If you have never turned VVV on before, expect to wait a short period while it installs PHP and other tools.

You may be asked for an admin password at the beginning. This will be your computers administrative password or the password used for sudo.

Turning VVV Off

Change into the VVV folder and run:

vagrant halt

This will shut down the virtual machine. If the machine is frozen for whatever reason, add the ` –force` parameter. If it still refuses to power off, open VirtualBox and manually power the VM off.

You may be asked for an admin password to remove hosts.

Restarting VVV

Change into the VVV folder and run:

vagrant reload

This will do a restart of the Virtual Machine, and is the same as running vagrant halt followed by vagrant up.

Running Commands Inside VVV

Turn VVV on then change into the VVV folder and run:

vagrant ssh

Now you are inside VVV, and in an Ubuntu shell. You can use all the commands VVV uses such as npm or node. You will find your www folder with all your sites at /srv/www. When you are done, use the exit command to return to your host machine.

Applying Updates and config/config.yml Changes

If you update VVV or change the config.yml file, you must re-provision to apply the changes. To do this, change into the VVV folder run:

vagrant up --provision

If you ever have problems with VVV, re-provision again, and if there is still a problem, send the full output to us on Github or Slack.

Changing Into The VVV Folder

To run commands, you need to open a terminal and change into the VVV folder. Open a terminal or if you are on Windows and elevated/admin command prompt then change into the VVV folder like this:


cd ~/vvv-local

Windows elevated/admin command prompt:

cd %systemdrive%%homepath%/vvv-local

Older instructions used vagrant-local instead of vvv-local. If you installed VVV to vagrant-local or another location, swap vvv-local for your preferred location.

Using a GUI

This documentation assumes some very basic terminal/command line knowledge to run simple commands. However, some people prefer the convenience of a visual UI. If you fall into this category then consider the Vagrant Manager project.

Note: Until you provision VVV for the first time, Vagrant Manager will not pick up VVV. Running vagrant up --provision inside the VVV folder and allowing it to successfully finish should be enough.