Install WordPress with Docker

docker-compose configuration file

Inspect the content of the docker-compose.yml file, which defines 4 services:

• WordPress/PHP
• MySQL database
• phpMyAdmin interface to the database
• wpcli: WordPress command line interface
• healthcheck, which check whether services (MySQL, wordpress) are ready

version: '3.6'
services:

  wordpress:
    image: wordpress:${WORDPRESS_VERSION:-latest}
    container_name: ${COMPOSE_PROJECT_NAME:-wordpress}
    volumes:
      - ./config/php.conf.ini:/usr/local/etc/php/conf.d/php.ini
      - ${WORDPRESS_DATA_DIR:-./wordpress}:/var/www/html
    environment:
      - WORDPRESS_DB_NAME=${COMPOSE_PROJECT_NAME:-wordpress}
      - WORDPRESS_TABLE_PREFIX=${WORDPRESS_TABLE_PREFIX:-wp_}
      - WORDPRESS_DB_HOST=${WORDPRESS_DB_HOST:-mysql}
      - WORDPRESS_DB_USER=${DATABASE_USER:-root}
      - WORDPRESS_DB_PASSWORD=${DATABASE_PASSWORD:-password}
    depends_on:
      - mysql
      - phpmyadmin
    restart: always
    ports:
        - 80:80

  mysql:
    image: mariadb:${MARIADB_VERSION:-latest}
    container_name: ${COMPOSE_PROJECT_NAME}_mysql
    volumes:
      - ./mysql:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=${DATABASE_PASSWORD:-password}
      - MYSQL_USER=${DATABASE_USER:-root}
      - MYSQL_PASSWORD=${DATABASE_PASSWORD:-password}
      - MYSQL_DATABASE=${COMPOSE_PROJECT_NAME:-wordpress}
    restart: always

  phpmyadmin:
    depends_on:
      - mysql
    image: phpmyadmin/phpmyadmin:${PHPMYADMIN_VERSION:-latest}
    container_name: ${COMPOSE_PROJECT_NAME}_phpmyadmin
    restart: always
    ports:
      - ${PHPMYADMIN_PORT}:80
    environment:
      PMA_HOST: mysql
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD:-password}

  # Command line interface to wordpress
  wpcli:
    build: ./wpcli/
    image: wpcli
    container_name: ${COMPOSE_PROJECT_NAME}_wpcli
    volumes:
      - ${WORDPRESS_DATA_DIR:-./wordpress}:/var/www/html
    working_dir: /var/www/html

# Check availability of essential services
  healthcheck:
    image: wpcli
    build: ./wpcli/
    container_name: ${COMPOSE_PROJECT_NAME}_healthcheck
    command: sh -c "/wait"
    environment:
      - WAIT_HOSTS=mysql:3306, wordpress:80
      - WAIT_BEFORE_HOSTS=${WAIT_BEFORE_HOSTS:-30}
      - WAIT_AFTER_HOSTS=${WAIT_AFTER_HOSTS:-15}
      - WAIT_HOSTS_TIMEOUT=${WAIT_HOSTS_TIMEOUT:-300}
      - WAIT_SLEEP_INTERVAL=${WAIT_SLEEP_INTERVAL:-30}
      - WAIT_HOST_CONNECT_TIMEOUT=${WAIT_HOST_CONNECT_TIMEOUT:-30}

Contents of: ./config/php.conf.ini

file_uploads = On
memory_limit = 512M
upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 600

  adminer:
    image: adminer
    restart: always
    links:
      - mysql
    ports:
      - 8080:8080

WP Cli Dockerfile and configuration file

The WordPress cli is built from the following Dockerfile, which includes the docker-compose-wait tool. The wait tool makes it possible to wait for a container to be ready before running another container. This makes wp-cli wait for MySQL to be ready before manipulating the database.

WP Cli Dockerfile (path: ./wpcli/Dockerfile):

FROM wordpress:cli

# Install make tool
USER root
RUN apk add --no-cache make

# Make docker-compose wait for container dependencies be ready
# Add the wait script to the image
ENV WAIT_VERSION 2.7.2
ADD https://github.com/ufoscout/docker-compose-wait/releases/download/$WAIT_VERSION/wait /wait
RUN chmod +x /wait

# Add Makefile to scripts dir
ADD Makefile entrypoint.sh /scripts/
RUN chmod +x /scripts/entrypoint.sh

ENTRYPOINT [ "/scripts/entrypoint.sh" ]
USER 33:33
CMD ["wp", "shell"]

This Dockerfile is based on wordpress:cli, installs the docker-compose-wait and has an entrypoint, which can either execute WP-cli or a Makefile.

The WP Cli tool automates the installation of WordPress using the following Makefile (path: ./wpcli/Makefile):

install: configure

configure:

    @echo "⚙️ Configuring WordPress parameters..."
    wp core install \
        --url=${WORDPRESS_WEBSITE_URL_WITHOUT_HTTP} \
        --title=$(WORDPRESS_WEBSITE_TITLE) \
        --admin_user=${WORDPRESS_ADMIN_USER} \
        --admin_password=${WORDPRESS_ADMIN_PASSWORD} \
        --admin_email=${WORDPRESS_ADMIN_EMAIL}

    wp option update siteurl ${WORDPRESS_WEBSITE_URL}
    wp rewrite structure $(WORDPRESS_WEBSITE_POST_URL_STRUCTURE)

Using this Makefile, the WP-Cli tool will configure:

• URL and title of website.
• URL structure.

Make commands for automatic WordPress setup

Path: ./Makefile

start:
    docker-compose up -d --build

healthcheck:
    docker-compose run --rm healthcheck

down:
    docker-compose down

install: start healthcheck

configure:
    docker-compose -f docker-compose.yml -f wp-auto-config.yml run --rm wp-auto-config

autoinstall: start
    docker-compose -f docker-compose.yml -f wp-auto-config.yml run --rm wp-auto-config

clean: down
    @echo "💥 Removing related folders/files..."
    @rm -rf  mysql/* wordpress/*

reset: clean

Thanks to this Makefile, you will be able to automatically install and configure wordpress using make autoinstall.