VVV logo VVV

There are 3 ways to define hosts

The recommended way is to use the config/config.yml file. vvv-hosts is supported for backwards compatibility, and vvv-init.sh can be used for edge circumstances.

When changing hosts, the Nginx config will need updating so that Nginx knows to listen for requests on those domains. If this isn’t done, the VVV dashboard will appear instead of the desired site. If the vagrant-goodhosts plugin is installed (See the requirements), this will also add the domain to your machine’s HOST file.

Always Reprovision on Changes

Modifying a sites provisioner files, or config/config.yml, requires a reprovision to take effect. To do this run: vagrant up --provision


When adding a site in config/config.yml, add a hosts section listing the domains of that site. For example:

    - example.com

This will map example.com to the example site, and update the hosts file on your machine.

vvv-hosts files

VVV 1 added hosts using a file named vvv-hosts, and VVV 2 continues support for this for backwards compatibility reasons. config.yml should always be preferred.

Place this as a text file with no file extension in a provision subfolder, or in the root of the site. Here’s an example that adds 2 domains:


For fast performance, put vvv-hosts in the root of the site, or a .vvv/provision subfolder. This will avoid a 3 level deep folder search.

Note that VVV will not add these hosts the first time you add the site. This is because the VVV updates the hosts file before sites are set up. The second time you reprovision it will be added.