Skip to content
Drupal Contrib by Biko2
Perl ApacheConf Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Native docker-based local environment for Drupal

Use this Docker compose file to spin up local environment for Drupal with a native Docker app

This docker setup works with Debian 8, Apache 2.4, MySQL 5.7/5.6/5.5/ and PHP 7.1/7.0/5.6.

This is keopx Docker Drupal optimized images for apache-php with varnish and MySQL.


The Drupal bundle consist of the following containers:

Container Version Service name Image Public Port Enabled by default
Apache PHP 7.1/7.0/5.6 apache-php keopx/apache-php 8008
MySQL 5.7/5.6/5.5 mysql keopx/mysql 3306
phpMyAdmin phpmyadmin phpmyadmin/phpmyadmin 8080
Mailhog mailhog mailhog/mailhog 8025 - 1025


Feel free to adjust volumes and ports in the compose file for your convenience.



$ docker-compose up -d


$ docker-compose stop

Or down (warning: this command remove volume changes):

$ docker-compose down

Run bash

docker exec -it dockerdrupalcontrib_web_1 /bin/bash

Replace dockerdrupalcontrib_web_1 with name of:

docker-compose ps

Install Drupal

echo ‘ mysql’ >> /etc/hosts
git clone
cd docker-drupal-contrib/data/www
docker-compose up -d
docker-compose down && docker-compose up -d
Access to site


Apache PHP



This is a default image. Only use to have a easy access to database information.


This is a default image. Use to have easy mailsender and mail watcher to test email without send to real account.

Custom settings

Apache PHP

Web Data Volume

      - ./data/www:/var/www # Data.

Apache Virtualhost

By default you can use http://localhost as working place. But if you would like a custom host to work add this changes.

You can see volumes to check existing configurations for vhosts. vhosts volume mount by default to help with setup.

    - ./config/vhosts:/etc/apache2/sites-enabled

Note: this example is for www.drupal8.local site.


cp config/vhosts/example.conf.example config/vhosts/drupal8.conf
sed -i 's/example/drupal8/' config/vhosts/drupal8.conf

NOTE: review your project path.

Add to /etc/hosts new site name:

echo " drupal8.local www.drupa8.local" >> /etc/hosts

And reload system:

$ docker-compose stop
$ docker-compose up -d


Use some setup by default. You can (un)comment to change behaviour.

You can see two php.ini templates with different setup, development and production setup.

In addition, you can check opcache, xdebug and xhprof configuration, the same file for php 7.1, 7.0 and 5.6, and opcache recomended file version for Drupal.

PHP 5.6
      # php.ini for php 5.6 and remove environment varibles.
      - ./config/php/5.6/php.ini:/etc/php5/apache2/php.ini
      # Opcache for php 5.6
      - ./config/php/opcache-recommended.ini:/etc/php5/apache2/conf.d/05-opcache.ini
      # Xdebug for php 5.6.
      - ./config/php/xdebug.ini:/etc/php5/apache2/conf.d/20-xdebug.ini
      # Xhprof for php 5.6.
      - ./config/php/xhprof.ini:/etc/php5/apache2/conf.d/20-xhprof.ini
PHP >= 7.0

This example is for PHP 7.0. If you would like use PHP 7.1 change the next lines from 7.0 to 7.1.

      # php.ini for php 7.x and remove environment varibles.
      - ./config/php/7.0/php.ini:/etc/php/7.0/apache2/php.ini
      # Opcache for php 7.0.
      - ./config/php/opcache-recommended.ini:/etc/php/7.0/apache2/conf.d/10-opcache.ini
      # Xdebug for php 7.0.
      - ./config/php/xdebug.ini:/etc/php/7.0/apache2/conf.d/20-xdebug.ini
      # Xhprof for php 7.0.
      - ./config/php/xhprof.ini:/etc/php/7.0/apache2/conf.d/20-xhprof.ini

e.g.: if you need add more PHP memory_limit modify ./config/php-{version}/php.ini file and reload system to works:

$ docker-compose stop
$ docker-compose up -d


If you need run some drush command to sync with some alias, to access to remote sync database or files you can uncomment next line to works into docker image.

      # Drush support. e.g.
      - ~/.drush:/root/.drush


If you need run some command, like a composer, to access to remote using ssh keys, you can uncomment next line to works into docker image.

      # SSH support. e.g.
      - ~/.ssh:/root/.ssh


WARNING: Use only if you not use custom php.ini.

You can check in docker-composer.yml two special environment variable to setup SMTP service to test local emails.

The apache-php has ssmtp sender package. Here default setup to run by default with mailhog.

Use to connect to MailHog mail instead localhost.

      # ssmtp mail sender.
      - PHP_SENDMAIL_PATH="/usr/sbin/ssmtp -t"
      # SMTP server configruation: "domain:port" | "mail" server domain is mailhog name.
      - PHP_SENDMAIL_DOMAIN=mail:1025


Use to connect to MySQl mysql instead localhost.

MySQL Data Volume

      - ./data/database:/var/lib/mysql

Custom my.cnf

You can check my.cnf and change you need variables.

      ## Custom setup for MySQL
      - ./config/mysql/my.cnf:/etc/mysql/my.cnf


  • MYSQL_ROOT_PASSWORD: The password for the root user. Defaults to a blank password.
  • MYSQL_DATABASE: A database to automatically create. If not provided, does not create a database.
  • MYSQL_USER: A user to create that has access to the database specified by MYSQL_DATABASE.
  • MYSQL_PASSWORD: The password for MYSQL_USER. Defaults to a blank password.
      - MYSQL_DATABASE=drupal
      - MYSQL_USER=drupaluser
      - MYSQL_PASSWORD=drupalpass


Use to connect to MySQl mysql instead localhost.


  • PMA_HOST: Host to connect phpMyAdmin.
      - PMA_HOST=mysql


Default image and setup.

You can’t perform that action at this time.