Quick Guide to Implement WordPress On Docker in Just 10 Min?

WordPresss on Docker

WordPress is an opensource, easy to build CMS (Content Management System) proudly built with a combination of PHP and MySQL. It is barely impossible that a person doesn’t know about it or hasn’t heard about WordPress. Hence it is a popular choice for a Web Developer when creating different types of websites, from blogs to eCommerce.

To run a WordPress site, we need LAMP (Linux, Apache, MySQL, and PHP) or LEMP (Linux, Nginx, MySQL, and PHP) stack, which can take time 3 times meaning local, staging, and production servers. However, by using Docker and Docker Compose, we can simplify the process of setting up preferred stack and installing WordPress. What Is Docker? – Docker is open-source software that creates environments to build, share and run an application. Hence, you develop, test, and run multiple applications on the same machine.

In this article, we will build a multi-container WordPress install means WordPress Containerization With Docker. So we are going to create containers for MySQL Database, PhpMyAdmin, and WordPress itself.

Installation 

Install Docker 

To install Docker CE please follow the official website, based on your Operation System. 

Install Docker Compose 

To install Docker CE please follow the official website, based on your Operation System.  

Setup WordPress on Docker

Let’s move forward and configure our Docker compose for WordPress. One can do this by using Docker CLI, but here we are going to follow the more simple and systematic method that Docker compose. 

  1. Create a new Directory “wordpress” for WordPress:
    mkdir ~/wordpress/

    then move into it: 

    cd ~/wordpress/
  2. Create a new folder “.docker” in the newly created folder, this folder will contain all our extra config files:
    mkdir .docker
  3. In this “.docker” folder create a file called “uploads.ini”, as the name stats it will provide us control on PHP configurations. Let’s put the content below, you can modify these or addon more based on your project needs –
    file_uploads = On 
    memory_limit = 128M 
    upload_max_filesize = 128M 
    post_max_size = 128M 
    max_execution_time = 120
  4. Now create a file in “.docker” folder called “php-apache.conf”, this will set up Virtual Host for our us. Paste the content below, you can modify these or addon more based on your project needs –
    # Virtual Hosts 
    # 
    <VirtualHost *:80> 
        ServerAdmin webmaster@assetlibrary.test 
        DocumentRoot "/var/www/html" 
        ServerName example.wordpress 
        #ErrorLog "logs/example.wordpress-error.log" 
        #CustomLog "logs/example.wordpress-access.log" common 
    </VirtualHost>

     

  5. Now let’s create a file “.env” in root folder that is “wordpress” this file contains all environment variables DB details etc., and paste the below content into it –
    # The table prefix (Required) of the WordPress database used in our website 
    # Ex. wp_ 
    db_table_prefix=wp_ 
      
    # You can disable any of the plugins that are not needed for development, ex. Bulletproof Security or any SEO plugin. 
    # Comma (,) separated list as a string (no spaces), leave blank if you don't want to disable plugins.  
    # Ex. plugin-folder-name-1,plugin-folder-name-2 
    wp_plugins_to_disable=  
    wp_debug_mode=0 
      
    #################################################### 
    ### Defaults - can be left as it is for basic usage #################################################### 
    db_host=assetsdb 
    db_user=asset_user 
    db_password=asset_pwd 
    db_name=asset_db 
    db_root_password=root 
    db_port=3309
  6. Now let’s create a file called “docker-compose.yml”, here this is the main file that holds all the docker configurations for us. Paste the content below in the file. 

    Let’s understand a little about the configuration from this file. As you can see there are 2 heads of services and volumes.  
    A. There are 3 services db, wordpress, and phpmyadmin
    db: Used official mysql image for this service, you can have a look here
    wordpress: I used an official wordpress image for this service, you can have a look here
    phpmyadmin: I used an official phpmyadmin image for this service, you can have a look here

    B. There is a volume named persistent, that is used for mysql. It means that our DB volume will be persistent whenever we start the container. One can change this name if he wants to, I used persistent to remember its feature.

        version: "3.9" 
        services: 
            db: 
                container_name: assetsdb 
                image: mysql 
                volumes: 
                    - ./dump:/docker-entrypoint-initdb.d 
                    - persistent:/var/lib/mysql 
                restart: always 
                ports:  
                    - '3309:3306' 
                environment: 
                    MYSQL_ROOT_PASSWORD: $db_root_password 
                    MYSQL_DATABASE: $db_name 
                    MYSQL_USER: $db_user 
                    MYSQL_PASSWORD: $db_password 
            wordpress: 
                #depends_on: 
                #  - db 
                links: 
                    - db 
                image: wordpress:latest 
                volumes: 
                    - ./wp-content:/var/www/html/wp-content 
                    - ./apache-logs:/var/log/apache2 
                    - ./.docker/php-apache.conf:/etc/apache2/sites-enabled/000-default.conf 
                    - ./.docker/uploads.ini:/usr/local/etc/php/conf.d/uploads.ini 
                ports: 
                    - "80:80" 
                restart: always 
                environment: 
                    WORDPRESS_DB_HOST: $db_host 
                    WORDPRESS_DB_USER: $db_user 
                    WORDPRESS_DB_PASSWORD: $db_password 
                    WORDPRESS_DB_NAME: $db_name 
                    WORDPRESS_TABLE_PREFIX: $db_table_prefix 
                    WORDPRESS_DEBUG: $wp_debug_mode 
                    DISABLED_PLUGINS: $wp_plugins_to_disable 
            phpmyadmin: 
                image: phpmyadmin 
                restart: always 
                ports: 
                    - 8089:80 
                links:  
                    - db:db 
                environment: 
                    MYSQL_USER: $db_user 
                    MYSQL_PASSWORD: $db_password 
                    MYSQL_ROOT_PASSWORD: $db_root_password 
        volumes: 
            persistent: 
  7. This is an optional step to follow, that is to add our Virtual Host in Operating System’s host file. 
    For Windows, with Administrative rights 

    Hosts file (hosts) location of the in windows – c:WindowsSystem32Driversetchosts 
    For Linux, with root access use following command:

    sudo nano /etc/hosts

    Append the following line in the file: 

    127.0.0.1 example.wordpress

    Now you are ready to use your WordPress installation at the domain http://example.wordpress after running the container and then install WordPress in Docker Container. 

Usage

Build, (re)create, start, and attache to containers

You can start the container with the up command in Daemon Mode (by adding -d as an argument). Your WordPress will be running and available at this link http://127.0.0.1:80

docker-compose up

Starting containers 

 Start existing containers using the start command –

docker-compose start

Stopping containers 

docker-compose stop

Removing containers 

The use of down command will stop and remove all the containers –

docker-compose down

Use -v if you need to delete the database volume that is used to maintain the database –

docker-compose down –v

PhpMyAdmin 

You will have to visit http://127.0.0.1:8081 to access phpMyAdmin after starting the container. 

MySQL default username is root, and the password is the same as supplied in the .env file. 

 

Please go through the official documentation here for more commands in details. 

To sum up, Docker is the best open-source software tool to create containers. Its simple environment configuration helps us in maintaining server resources. When we want simple and ready to use environment on each level of the SDLC (Software Development Life Cycle) Docker is a favorite tool.

In this article, we have learned Docker basics and how we can setup WordPress in Docker using Docker Compose. We will be glad to resolve your queries so please be open to ask  questions.

Next Steps

I have more ideas that we can implement and extend the above setup: 

  1. Setting-up multisite WordPress in the Docker container 
  2. Setting-up and apply SSL certificates for the Virtual Host 
  3. Using Cron jobs within the Docker Container
  4. And many more you can think of

Stay connected for more updates…

Related post

Zabbix 6.2

Zabbix 6.2 – More Powerful, Featureful, & Secure

The focus of infrastructure monitoring software company Zabbix has always been on innovation. Over the past 6 versions, the software company has made some necessary big and minor changes in its front end and back end to enhance usability and overall user experience.  

Read More »