Public | Automated Build

Last pushed: a year ago
Short Description
A Drop-in Docker environment for Drupal module testing.
Full Description


A Drop-in Docker environment for Drupal module testing


Dropwhale is a drop-in Docker environment aimed at Drupal module
developers. Instead of maintaining a separate Drupal installation,
Dropwhale does all the downloading and initialization of Drupal with a
few easy commands. No need for you to download and install core. No
need to argue with xdebug or get Drush installed. It's all built in!


  1. Download Dropwhale and copy the following files to the root of your module repository:
    • The .dropwhale/ directory
    • docker-compose.yml
    • dropwhale.settings.example
  2. You can choose to commit the directory to your module repository, or gitignore it. Dropwhale doesn't care.
  3. Rename dropwhale.settings.examples to dropwhale.settings.
  4. Edit dropwhale.settings, replace your_module_name with your module machine name.
  5. Make any other changes to dropwhale.settings, if desired.
  6. cd to the root of your module repository. Execute .dropwhale/

If you need to rebuild from a clean version of Drupal, run .dropwhale/


Dropwhale is licensed under the GPLv3.


Version 2.0

  • New containers based on Alpine Linux for a smaller download size.
  • Switched from Apache to Nginx and PHP-FPM.
  • renamed to for better clarity.
  • Settings moved from Docker override file to dropwhale.settings.
  • will now display an error if dropwhale.settings isn't found.
  • New MODULE_NAME setting and ADDITIONAL_MODULES settings.
  • run-tests.php now will run your module's tests when no parameters are given.
  • The parent directory is now mounted at /module, and symlinked into drupal/modules when built.
  • now asks with a more friendly message before deleting.
  • now deletes volumes too.

Version 0.5

  • Various fixes
  • Added script.

Version 0.4

  • Use DRUPAL_USER and DRUPAL_PASSWORD to set login credentials.
  • Switched to socketwench/drupal-base:8-xdebug and socketwench/drupal-cli.
  • Moved docker-compose.*.yml files into root directory.
  • Removed hardcoded 8.0.x branch pull in, now pulls from default branch.
  • Added composer install to
  • Commented helper scripts for MOAR HACKABILITY.
  • Added script so you never have to log in.
  • Updated helper scripts to preserve working directory.

Version 0.3

  • Switched to more standardized containers to speed build process.
  • PHP 7 with OpCache.
  • Added missing php.ini to web container.
  • Added helper scripts for PHPUnit testing and nuking docker.
  • XDebug Support!
Docker Pull Command
Source Repository