A VM for local Drupal development, built with Vagrant + Ansible
macOS Windows Linux

Getting Started

tl;dr: Read the Quick Start Guide.

This project aims to make spinning up a simple local Drupal test/development environment incredibly quick and easy, and to introduce new developers to the wonderful world of Drupal development on local virtual machines (instead of crufty old MAMP/WAMP-based development).

It will install the following on an Ubuntu 16.04 (by default) linux VM:

  • Apache 2.4.x (or Nginx 1.x)
  • PHP 7.0.x (configurable)
  • MySQL 5.7.x (or MariaDB)
  • Drush (configurable)
  • Drupal 7.x, or 8.x.x (configurable)
  • Optional (installed by default):
    • Drupal Console
    • Varnish
    • Apache Solr
    • Node.js
    • Selenium, for testing your sites via Behat
    • Ruby
    • Memcached
    • Redis
    • SQLite
    • XHProf, for profiling your code
    • Blackfire, for profiling your code
    • XDebug, for debugging your code
    • Adminer, for accessing databases directly
    • Pimp my Log, for easy viewing of log files
    • MailHog, for catching and debugging email

It should take 5-10 minutes to build or rebuild the VM from scratch on a decent broadband connection.

Please read through the official documentation:

This VM includes many convenient utilities for local development, most of which can be enabled or disabled as you see fit (not everyone needs or wants an extra bundle of junk that they don't care about wasting their workstation's resources!).


Read the Drupal VM Documentation to learn more about how Drupal VM can fit in your development workflow.


Drupal VM - Dashboard

Drupal VM - Setup and Test Site


Maintained by Jeff Geerling (geerlingguy), author of Ansible for DevOps.