An open source Vagrant configuration for developing with WordPress
tomjn Merge pull request #1684 from meitar/mailhog-readme
Replace Mailcatcher with Mailhog in ``.
Latest commit 3536a2c Dec 16, 2018

Varying Vagrant Vagrants

Varying Vagrant Vagrants is an open source Vagrant configuration focused on WordPress development.

VVV is a 10up creation and transitioned to a community organization in 2014.

VVV is under the MIT License.


  • Approachable development environment with a modern server configuration.
  • Stable state of software and configuration in default provisioning.
  • Excellent and clear documentation to aid in learning and scaffolding.

VVV is ideal for developing themes and plugins, as well as for contributing to WordPress core.

Minimum System requirements

Software included

VVV is built on a Ubuntu 14.04 LTS (Trusty) base VM and provisions the server with current versions of several software packages, including:

  1. Nginx (mainline)
  2. MariaDB 10.1.x (drop-in replacement for MySQL)
  3. PHP FPM 7.2.x
  4. WP-CLI
  5. Memcached
  6. PHPUnit
  7. Composer
  8. NodeJs v10
  9. Mailhog

For a more comprehensive list, please see the list of installed packages.

How to Use VVV

VVV requires recent versions of both Vagrant and VirtualBox.

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.

Besides VirtualBox, provider support is also included for Parallels, Hyper-V, VMWare Fusion, and VMWare Workstation.

The online documentation contains detailed installation instructions.

Full documentation can be found on the website.


A full list of contributors can be found here.