Skip to content
This repository has been archived by the owner. It is now read-only.
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Drupal VM Live Site Repository

Build Status

This project was built using the drupal-project Drupal Composer template, and is used to demonstrate Drupal VM's local and production environment management capabilities.

The motivation behind this project and the process to build the initial version are documented in Jeff Geerling's blog post Soup to Nuts: Using Drupal VM to build local and prod.


You should have the following installed on your local environment prior to working on this project:

  1. Vagrant, VirtualBox and Ansible
  2. PHP and Composer
  3. Vagrant plugins: vagrant-vbguest, vagrant-hostsupdater

Local setup - Vagrant-based

If this is the first time you've cloned the project, run the following commands to get started developing:

  1. composer install
  2. vagrant up (you'll need to enter the Vault password at this point)

Once that's completed, you can visit in your browser to see the site locally.

Note: You can remove the secrets.yml file from the vm directory if you want to avoid using the vault password for testing purposes. For the local environment, the variables in that file are overridden in vagrant.config.yml anyways.

Local setup - Docker-based

  1. Edit your hosts file, and add the line:
  2. (If on Mac) Add an alias for the container's IP address: sudo ifconfig lo0 alias
  3. Run docker-compose up -d.
  4. Export the database from using MySQL.
  5. Import the database into the local environment using MySQL.

Once that's completed, you can visit in your browser to see the site locally.

To run Drush commands on the site, wrap the commands in docker exec, like so:

docker exec local-drupalvm bash -c "drush --root=/var/www/drupalvm/drupal/web status"

Prod setup

  1. Create a DigitalOcean Droplet (or basically any other VPS that gives you full control/root). The root user account on this VM should have your SSH key already added.
  2. Copy the example.vars.yml file to vars.yml inside vendor/geerlingguy/drupal-vm/examples/prod/bootstrap/ (for one-time use), and customize to your liking.
  3. Run the initialization playbook from the project root directory: ansible-playbook -i vm/inventory vendor/geerlingguy/drupal-vm/examples/prod/bootstrap/init.yml -e "ansible_ssh_user=root"
  4. Run the main Drupal VM playbook to build the server: DRUPALVM_ENV=prod ansible-playbook -i vm/inventory vendor/geerlingguy/drupal-vm/provisioning/playbook.yml -e "config_dir=$(pwd)/vm" --become --ask-become-pass


  • Only the repository's owner has the SSH keys for accessing the actual live site, and the Vault password for the protected variables inside secrets.yml.
  • When running the production playbook, you should ensure a ~/.ansible/prod-drupalvm-vault-password.txt file exists, containing one line with the Vault password used to encrypt the vm/secrets.yml file. If the password file is not present, pass --ask-vault-pass to the ansible-playbook command and enter the password at runtime.

Keeping things Secret

If you decide to store some private variables in an Ansible Vault-encrypted vars file, then you should run all Vagrant commands like:

DRUPALVM_ANSIBLE_ARGS='--ask-vault-pass' vagrant [command]

And when running Ansible commands, use:

ansible-playbook [args] --ask-vault-pass

You can also pass a file path containing the vault password, if you need to do automated deployments. See Ansible's Vault Documentation for more info.

Running Behat tests

This codebase includes Behat behavioral tests in the tests directory. To run the tests, make sure you have the local environment running, then inside the tests directory, run:

# If using Drupal VM with Vagrant locally accessed at ``.
../vendor/bin/behat --config behat.yml

# If using Drupal VM with Docker locally accessed at `localhost`.
../vendor/bin/behat --config behat-docker.yml


This project is maintained by Jeff Geerling, author of Ansible for DevOps and maintainer of Drupal VM.