Public | Automated Build

Last pushed: 19 hours ago
Short Description
Easy and fast way to have the latest Drupal8 running on your box in minutes!
Full Description


This repo contains a recipe for making a Docker container
running Drupal8, using Linux, Apache, MySQL, Memcache and SSH.
You can also use it on the Drupal Sprints for quickly starting
working on your Drupal8 git repo.
To use it, make sure you first Install Docker.

Quick 3 step instructions for single run:

1 - Install docker:

2 - Get the image and run it using port 80:

sudo docker run -i -t -p 80:80 ricardoamaro/drupal8

That's it!

3 - Visit http://localhost/ in your browser

using user/pass: admin/admin

4 - Manage MySQL in your browser



If you want Code and Database persistence with an already
existent Drupal8 code that you have on your computer, run it with:

cd; mkdir d8; cd d8

git clone --depth 5 --branch 8.3.x
cd drupal
sudo apt-get install composer
composer install

sudo docker run -it \
--volume=$HOME/d8/mysql:/var/lib/mysql \
--volume=$HOME/d8/drupal:/var/www/html \
-p 80:80 -p 3306:3306 ricardoamaro/drupal8

You can remove the local settings.php and the mysql directory
for a fresh Drupal8 install with existent code:

cd $HOME/d8
sudo rm -rf mysql/ repo/sites/default/settings.php


  • Drupal account-name=admin & account-pass=admin
  • ROOT SSH/MYSQL PASSWORD will be on /mysql-root-pw.txt
  • DRUPAL MYSQL_PASSWORD will be on /drupal-db-pw.txt

How to go back to the last docker run?

sudo docker ps -al
(get the container ID)
sudo docker start -i -a (container ID)

Example usage for testing:

Using docker exec {ID} {COMMAND}, to run your own commands.

~$ sudo docker run --name mydrupal8 -i -t -p 80:80 ricardoamaro/drupal8

~$ sudo docker exec mydrupal8  uptime
 10:02:59 up 16:41,  0 users,  load average: 1.17, 0.92, 0.76

~$ sudo docker exec mydrupal8 drush status | head
 Drupal version         :  8.0.0-beta12
 Site URI               :  http://default
 Database driver        :  mysql
 Database hostname      :  localhost
 Database port          :  3306
 Drupal bootstrap       :  Successful

For older Drupal versions check:

You can also clone this repo somewhere and build it,

git clone
cd drupal8-docker-app
sudo docker build -t <yourname>/drupal8 .

Or build it directly from github,

sudo docker build -t ricardo/drupal8

Note1: you cannot have port 80 already used or the container will not start.
In that case you can start by setting: -p 8080:80

Note2: To run the container in the background

sudo docker run -d -t -p 80:80 <yourname>/drupal8

More docker awesomeness

This will create an ID that you can start/stop/commit changes:

# sudo docker ps
ID                  IMAGE                   COMMAND               CREATED             STATUS              PORTS
538example20        <yourname>/drupal8:latest   /bin/bash /   3 minutes ago       Up 6 seconds        80->80


sudo docker stop 538example20
sudo docker start 538example20

Commit the actual state to the image

sudo docker commit 538example20 <yourname>/drupal8

Starting again with the commited changes

sudo docker run -d -t -p 80:80 <yourname>/drupal8 /

Shipping the container image elsewhere

sudo docker push  <yourname>/drupal8

You can find more images using the Docker Index.

Clean up

While i am developing i use this to rm all old instances

sudo docker ps -a | awk '{print $1}' | grep -v CONTAINER | xargs -n1 -I {} sudo docker rm {}

Known Issues

  • Warning: This is still in development and ports shouldn't
    be open to the outside world.


Feel free to submit any bugs, requests, or fork and contribute
to this code. :)

  1. Fork the repo
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request


Created and maintained by Ricardo Amaro


GPL v3

Docker Pull Command
Source Repository