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:

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.