Drupal VM's configuration is designed to work with RedHat and Debian-compatible operating systems. Therefore, if you switch the vagrant_box in config.yml to any compatible OS, Drupal VM and all it's configuration should Just Work™... but that's not always the case.

Currently-supported OSes are:

  • Ubuntu 16.04
  • Ubuntu 14.04 (default)
  • Ubuntu 12.04
  • RedHat Enterprise Linux / CentOS 7
  • RedHat Enterprise Linux / CentOS 6

For certain OSes, there are a couple other caveats and tweaks you may need to perform to get things running smoothly—the main features and latest development is only guaranteed to work with the default OS as configured in example.config.yml.

Some other OSes should work, but are not regularly tested with Drupal VM, including Debian 8/Jessie (debian/jessie64) and Debian 7/Wheezy (debian/wheezy64).

Ubuntu 16.04 Xenial LTS

Ubuntu 16.04 is the latest LTS release, and there are a few changes currently required to make sure Drupal VM runs smoothly on it. Note also that Ubuntu 16.04 defaults to PHP 7; older versions of PHP will not be supported on this OS.

Redis: If using redis, add the line php_redis_package: php-redis to config.yml before provisioning.

Installed extras that are currently unsupported on Ubuntu 16.04:

  • memcached
  • selenium
  • varnish
  • xhprof

Ubuntu 14.04 Trusty LTS

Everything should work out of the box with Ubuntu 14.04.

Ubuntu 12.04 Precise LTS

Everything should work out of the box with Ubuntu 12.04.

RedHat Enterprise Linux / CentOS 7

Everything should work out of the box with RHEL 7.

RedHat Enterprise Linux / CentOS 6

Apache without FastCGI: If you want to use Apache with CentOS 6 on Drupal VM, you will need to modify the syntax of your apache_vhosts and remove the ProxyPassMatch parameters from each one. Alternatively, you can use Nginx with the default configuration by setting drupalvm_webserver: nginx inside config.yml.

PHP OpCache: PHP's OpCache (if you're using PHP > 5.5) requires the following setting to be configured in config.yml (see upstream bug: CentOS (6) needs additional php-opcache package):

php_opcache_enabled_in_ini: false