{"id":351,"date":"2020-01-06T09:00:00","date_gmt":"2020-01-06T09:00:00","guid":{"rendered":"http:\/\/yer.ac\/blog\/?p=351"},"modified":"2020-06-17T14:20:21","modified_gmt":"2020-06-17T14:20:21","slug":"using-docker-containers-for-easy-local-wordpress-development%f0%9f%90%b3","status":"publish","type":"post","link":"https:\/\/yer.ac\/blog\/2020\/01\/06\/using-docker-containers-for-easy-local-wordpress-development%f0%9f%90%b3\/","title":{"rendered":"Using Docker Containers for easy local WordPress development\ud83d\udc33"},"content":{"rendered":"\n

This will cover off setting up a Docker container for local WordPress development & mounting the container folder for easier development.<\/p>\n\n\n\n

NOTE: Updated to note possible performance issue in Docker using Windows Containers and mounted volumes. See the end of this post.<\/strong><\/p>\n\n\n\n

\"Containers,<\/figure>\n\n\n\n

Why do this?<\/h2>\n\n\n\n

Typically when doing any kind of WordPress work (Which is exceptionally<\/em> rare for me), I would spin up a new WP instance on my host, or use something like a local LAMP\/XAMP server.<\/p>\n\n\n\n

Whilst this works, leveraging things like Docker mean almost zero configuration and more time developing. Better still, these then become throwaway environments!<\/p>\n\n\n\n

Requirements<\/h2>\n\n\n\n

The only requirement for this is the installation of Docker (https:\/\/www.docker.com<\/a>)<\/p>\n\n\n\n

Creating the WordPress instance<\/h2>\n\n\n\n

Firstly, create the folder where the configuration will live, for example C:\\Docker\\Wordpress<\/code> In this folder we need to make a file named docker-compose.yml<\/code>. This will be the YAML file detailing our wordpress installation – such as login information and MySQL setup.<\/p>\n\n\n\n

In this file, copy and paste the content below:<\/p>\n\n\n\n

version: '3.1'\nservices:\n  wordpress:\n    image: wordpress\n    restart: always\n    ports:\n      - 1234:80\n    environment:\n      WORDPRESS_DB_HOST: db\n      WORDPRESS_DB_USER: exampleuser\n      WORDPRESS_DB_PASSWORD: examplepass\n      WORDPRESS_DB_NAME: exampledb\n  db:\n    image: mysql:5.7\n    restart: always\n    environment:\n      MYSQL_DATABASE: exampledb\n      MYSQL_USER: exampleuser\n      MYSQL_PASSWORD: examplepass\n      MYSQL_RANDOM_ROOT_PASSWORD: '1'\n<\/code><\/pre>\n\n\n\n
This will tell Docker that we need to use the image name “WordPress” from the Docker Hub (https:\/\/hub.docker.com\/_\/wordpress<\/a>), forward port 80 of the container (Which will be the exposed website) to port number 1234 of the parent host. This means going to http:\/\/localhost:1234 would go to port 80 of the docker container.<\/p>\n\n\n\n
Finally to use MySQL v5.7 as our database. You shouldn’t need to change this information, but if you do, make sure that the Database information in the wordpress<\/code> section matches the information in the db<\/code> section.<\/p>\n\n\n\n
Once this file is saved, we can run docker-compose up -d<\/code> whilst in the same directory. This will take the YAML file, download any images that are not already on the local system and then set WordPress and MySQL up based on the YAML.<\/p>\n\n\n\n
Note:<\/strong>: If you get the error no matching manifest for windows\/amd64 in the manifest list entries<\/code> when running this command, and you are on Windows 10, you will need to enable “Experimental Mode” in your Docker installation. To do this, right-click on Docker in the system tray and go to settings, checking the box named “Experimental mode”.<\/p><\/blockquote>\n\n\n\n
Note:<\/strong>: If you get an error like ERROR: for wordpress_db_1 Cannot create container for service db:<\/code>, this is usually caused by there being a conflict in ports. Try changing the external port (in this example “1234” for something else)<\/p><\/blockquote>\n\n\n\n
We can confirm if the docker container is running by running docker ps<\/code> to list all running containers, or by going to http:\/\/localhost:1234 (The port will be whatever you set it to in the YAML)<\/p>\n\n\n\n
From here you can follow the standard WordPress installation steps.<\/p>\n\n\n\n
Stopping and starting instances<\/h2>\n\n\n\n
You can stop and start instances by doing the following:<\/p>\n\n\n\n
docker-compose stop<\/code> and docker-compose up -d<\/code>. Stop may take a little while.<\/p>\n\n\n\n
Note that these commands (in this syntax) have to be ran at the same level as the YAML file.<\/p>\n\n\n\n
Working with the instance<\/h2>\n\n\n\n
If you just wanted to play with WordPress this would be enough, but what if you wanted to copy files to the instance, or edit files?<\/p>\n\n\n\n
Option 1: SSH\/ FTP<\/h3>\n\n\n\n
Although not personally a fan of this method, we could SSH to the container with a tool like PuTTY, see this guide: https:\/\/phase2.github.io\/devtools\/common-tasks\/ssh-into-a-container\/<\/a> We could also configure the container to have an FTP server. This won’t be covered as I believe the next option to be better.<\/p>\n\n\n\n
Option 2: Mount a windows folder<\/h3>\n\n\n\n
This option will mount a specific folder within the Docker container to a folder on your own system.<\/p>\n\n\n\n
Before continuing, we need to make sure that the container is currently stopped (docker-compose stop<\/code>)<\/p>\n\n\n\n
We will make a change to the YAML file so that we add a volumes<\/code> option, as shown below.<\/p>\n\n\n\n
version: '3.1'\n\nservices:\n\n  wordpress:\n    image: wordpress\n    restart: always\n    ports:\n      - 1234:80\n    environment:\n      WORDPRESS_DB_HOST: db\n      WORDPRESS_DB_USER: exampleuser\n      WORDPRESS_DB_PASSWORD: examplepass\n      WORDPRESS_DB_NAME: exampledb\n    volumes: \n    - \"C:\/Docker\/Wordpress\/Mounted:\/var\/www\/html\"\n\n  db:\n    image: mysql:5.7\n    restart: always\n    environment:\n      MYSQL_DATABASE: exampledb\n      MYSQL_USER: exampleuser\n      MYSQL_PASSWORD: examplepass\n      MYSQL_RANDOM_ROOT_PASSWORD: '1'\n<\/code><\/pre>\n\n\n\n
As we can see, the volumes<\/code> setting contains a string which is made up of 2 parts, seperated by a colon :<\/code>. These are:<\/p>\n\n\n\n