DEV Community

Prazol Rupakheti
Prazol Rupakheti

Posted on • Edited on

2

How to Set Up WordPress with Docker and WP-CLI?

#wordpress #docker #wpcli #php

Benefits of Dockerizing WordPress

  • Portability: Easily move your WordPress environment between machines.
  • Consistency: Avoid "it works on my machine" issues with standardized environments.
  • Easy Deployment: Quickly spin up and down environments without manual configuration.
  • Scalability: Easily add or remove services when needed.

WP-CLI Integration

Manage WordPress efficiently with command-line tools for installing, updating, and configuring WordPress. Easily use WP-CLI in the server to automate tasks and streamline management.

Folder Structure 

project/
│-- config/
│-- db/
│-- html/
│-- .gitignore
│-- docker-compose.yml
│-- Dockerfile
Enter fullscreen mode Exit fullscreen mode

Folder Descriptions

  • config/ – Contains configuration files like php.ini.
  • db/ – Stores MySQL database files (empty folder).
  • html/ – Contains WordPress files (download and rename WordPress folder as html).
  • .gitignore – Specifies files and folders to ignore in Git.
  • docker-compose.yml – Defines the Docker containers and their interactions.
  • Dockerfile – Defines how to build the web server environment.

Configuration Files

Example: config/php.ini

post_max_size = 128M
upload_max_filesize = 128M
serialize_precision = 6
memory_limit = 128M
max_execution_time = 300
Enter fullscreen mode Exit fullscreen mode

Example: .gitignore

db/
Enter fullscreen mode Exit fullscreen mode

Configure docker-compose.yml file

This file defines the services required for WordPress.

services:
  webapp:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: your-project-name
    expose:
      - 80
    ports:
      - 1000:80
    depends_on:
      - database
    working_dir: /var/www/html
    volumes:
      - ./html:/var/www/html
      - ./config/php.ini:/etc/php/8.2/apache2/conf.d/99-local.ini
    environment:
      MYSQL_HOST: database
      MYSQL_USER: admin
      MYSQL_PASSWORD: admin

  database:
    container_name: MySQL-8
    restart: always
    image: mysql:8
    volumes:
      - ./db:/var/lib/mysql
    expose:
      - 3306
    environment:
      MYSQL_ROOT_PASSWORD: admin
      MYSQL_USER: admin
      MYSQL_PASSWORD: admin
      MYSQL_DATABASE: your-project-name
Enter fullscreen mode Exit fullscreen mode

Configure Dockerfile file

This file defines the web server and PHP environment.

FROM ubuntu:20.04
LABEL name="Prazol Rupakheti"
ENV DEBIAN_FRONTEND=noninteractive

RUN apt-get update && \
    apt-get install -y --no-install-recommends apt-utils && \
    apt-get -y install wget zip unzip curl gnupg nano cron && \
    apt-get install lsb-release ca-certificates apt-transport-https software-properties-common -y

# Install Node.js, PM2, and Apache with PHP 8
RUN curl -fsSL https://deb.nodesource.com/setup_20.x | bash - && \
    apt-get install -y nodejs && \
    npm install -g npm@latest pm2 sass

RUN add-apt-repository ppa:ondrej/php -y && \
    apt-get -y install php8.2 apache2 libapache2-mod-php8.2 php8.2-cli php8.2-mysql php8.2-zip php8.2-gd \
      php8.2-mbstring php8.2-curl php8.2-xml php8.2-bcmath php8.2-imagick php8.2-intl mysql-client && \
    a2enmod rewrite headers expires

# Install phpMyAdmin
RUN wget -q https://files.phpmyadmin.net/phpMyAdmin/5.2.1/phpMyAdmin-5.2.1-english.zip && \
    unzip -q phpMyAdmin-5.2.1-english.zip && \
    mv phpMyAdmin-5.2.1-english /opt/phpMyAdmin && \
    rm phpMyAdmin-5.2.1-english.zip

# Install Composer
RUN wget -q https://getcomposer.org/download/latest-stable/composer.phar && \
    chmod +x composer.phar && \
    mv composer.phar /usr/local/bin/composer

# Install WP-CLI
RUN curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar && \
    chmod +x wp-cli.phar && \
    mv wp-cli.phar /usr/local/bin/wp

# Set up Apache
COPY config/000-default.conf /etc/apache2/sites-available
COPY config/phpmyadmin.conf /etc/apache2/conf-enabled
COPY config/99-local.ini /etc/php/8.2/apache2/conf.d/

EXPOSE 80
CMD apachectl -D FOREGROUND
Enter fullscreen mode Exit fullscreen mode

WordPress Configuration File html/wp-config.php

Modify the wp-config.php file inside the html/ folder.

/** The name of the database for WordPress */
define('DB_NAME', 'your-project-name');

/** Database username */
define('DB_USER', 'admin');

/** Database password */
define('DB_PASSWORD', 'admin');

/** Database hostname */
define('DB_HOST', 'database');
Enter fullscreen mode Exit fullscreen mode

Installing Docker

Windows & macOS

  1. Install Docker Desktop from Docker's official site.
  2. Ensure Docker is running.

Linux

  • Run the following commands to install Docker: 
sudo apt update
sudo apt install -y docker.io docker-compose
Enter fullscreen mode Exit fullscreen mode
  • Start and enable Docker: 
sudo systemctl start docker
sudo systemctl enable docker
Enter fullscreen mode Exit fullscreen mode

Running the Containers

Once everything is set up, open a terminal in the project root and run:

docker-compose up -d
Enter fullscreen mode Exit fullscreen mode

The -d flag stands for detached mode, which means the containers will run in the background instead of keeping the terminal occupied. This allows you to continue using the terminal while the containers are running.

This will start the WordPress and MySQL containers in the background.

Verifying the Containers

Check running containers with:

docker ps
Enter fullscreen mode Exit fullscreen mode

If using Docker Desktop, you should see two running containers:

  1. Web Server (Apache + PHP)
  2. MySQL Database

Image description

Using WP-CLI

To access the WordPress CLI inside the container, run:

docker exec -it your-project-name bash
Enter fullscreen mode Exit fullscreen mode

Then, check the installed WordPress version:

wp core version
Enter fullscreen mode Exit fullscreen mode

Image description

Accessing WordPress

  1. Open a browser and go to http://localhost:1000
  2. For phpmyadmin go to http://localhost:1000/phpmyadmin
  3. Follow the WordPress setup wizard.

Conclusion

You have successfully set up WordPress using Docker and WP-CLI. Now you can develop, test, and manage WordPress projects in a containerized environment, ensuring consistency across development and production systems.

Happy Coding

profile
Heroku
 Promoted

Heroku

Built for developers, by developers.

Whether you're building a simple prototype or a business-critical product, Heroku's fully-managed platform gives you the simplest path to delivering apps quickly — using the tools and languages you already love!

Learn More

Top comments (1)

Collapse
 
bampun profile image
Bampun •

lightweight, fast, and efficient WordPress development environment with Docker and WP-CLI. You can easily manage WordPress from the terminal, automate tasks, and speed up your workflow! ⚡

👋 Kindness is contagious

Explore a trove of insights in this engaging article, celebrated within our welcoming DEV Community. Developers from every background are invited to join and enhance our shared wisdom.

A genuine "thank you" can truly uplift someone’s day. Feel free to express your gratitude in the comments below!

On DEV, our collective exchange of knowledge lightens the road ahead and strengthens our community bonds. Found something valuable here? A small thank you to the author can make a big difference.

Okay