Deploying WordPress in Docker containers

Learn how to run a WordPress installation in Docker containers, both manually and using Docker Compose. WordPress developers will find it useful to deploy WordPress in Docker containers. Docker allows you to test on multiple WordPress configurations, and launch a fresh WordPress installation with a few simple commands.

    Requirements

    • A server running CentOS 7 or Ubuntu 14.04
    • Web services installed and running.
    • Docker installed and running.
    • Basic knowledge of Docker usage and commands.
    • Optional: A basic understanding of Docker Compose.

    Dedicated Server from IONOS

    Hardware meets cloud: dedicated server with cloud integration and per-minute billing, including a personal assistant! 

    24/7 support
    Unlimited traffic
    SSL certificate

    Running WordPress in Docker containers

    A successful WordPress installation has three elements:

    • The WordPress software

    • A MySQL or MariaDB database

    • The final installation steps, which are completed in a browser

    For the following examples, the WordPress and MySQL/MariaDB components will run in separate linked containers. The container running the WordPress software will be mapped to a port on the host, which will allow you to access it in a browser.

    Run a MySQL/MariaDB Container

    First, run a container named my-db with the root password of mysql-password. You can use either MySQL or MariaDB, which is a drop-in replacement for MySQL.

    Note

    Be sure to change db-password to a secure password.

    MySQL

    Launch a container with the command:

    sudo docker run --name my-db -e MYSQL_ROOT_PASSWORD=db-password -d mysql

    MariaDB

    Launch a container with the command:

    sudo docker run --name my-db -e MYSQL_ROOT_PASSWORD=db-password -d mariadb

    Run a WordPress container

    Next, run a container from the official WordPress image which is mapped to the host port 8080 and linked to the database container.

    Two notes:

    • If you have a firewall, you may need to add access to port 8080.
    • If you already have another service running on port 8080, you can choose a different port on the host.

    The command will vary slightly depending on whether you are using MySQL or MariaDB:

    MySQL

    Launch a WordPress container with the command:

    sudo docker run --name my-wordpress -p 8080:80 --link my-db:mysql -d wordpress

    WordPress Managed Hosting with IONOS!

    Start your website quickly and benefit from the most secure and up-to-date version of WordPress!

    Domain
    SSL
    24/7 support

    MariaDB

    Launch a WordPress container with the command:

    sudo docker run --name my-wordpress -p 8080:80 --link my-db:mariadb -d wordpress

    There are many other environment variables you can add to this command if you want to override the defaults, including:

    • -e WORDPRESS_DB_HOST=[hostname] The default is the IP address and port of the linked MySQL/MariaDB container. You can use this variable to access a MySQL/MariaDB database on another server.
    • -e WORDPRESS_DB_USER=[username] The default is root.
    • -e WORDPRESS_DB_PASSWORD=[password] The default is the MYSQL_ROOT_PASSWORD environment variable of the linked MySQL/MariaDB container.
    • -WORDPRESS_DB_NAME=[name] The default is "wordpress".

    Finish the installation in a browser

    For the final installation steps, you will need to access the WordPress container from a browser.

    In the previous example we mapped port 8080 on the host to port 80 (web services) on the container. This allows you to access the container in a browser using either the IP address or the URL of the server:

    Visit the URL in a browser, choose your install language, then click Continue.

    choose your install language

    On the next page, fill out the fields.

    install WordPress
    • Site Title: Fill out the title of your website.
    • Username: This will be the main administrative username for your site. Note: for security reasons, we recommend that you do NOT use "Admin" or your website's name or URL for this username.
    • Password: Make a note of this password before you continue.
    • Your Email: This will be the email address for the main administrative username.

    Then click the Install WordPress button to finalize the installation.

    Using Docker Compose to run WordPress

    It is easy to launch WordPress installations with Docker Compose. For information on installing and using Docker Compose, see our article Docker: Orchestration of multi-container apps with Swarm and Compose.

    Create the YAML file

    First, create a directory for your project and move into it:

    sudo mkdir wordpress
cd wordpress

    Create a YAML file named docker-compose.yml with the command:

    sudo nano docker-compose.yml

    The contents of the file will vary slightly depending on whether you are using MySQL or MariaDB:

    MySQL

    Put the following into the file:

    wordpress:
  image: wordpress
  links:
    - wordpress_db:mysql
  ports:
    - 8080:80

wordpress_db:
  image: mysql
  environment:
    MYSQL_ROOT_PASSWORD: db-password
    Note

    Be sure to change db-password to a secure password.

    Save and exit the file.

    MariaDB

    Put the following into the file:

    wordpress:
  image: wordpress
  links:
    - wordpress_db:mariadb
  ports:
    - 8080:80

wordpress_db:
  image: mariadb
  environment:
    MYSQL_ROOT_PASSWORD: db-password
    Note

    Be sure to change db-password to a secure password.

    Save and exit the file.

    Launch the containers

    Next, use Docker Compose to launch these containers with the command:

    sudo docker-compose up -d

    You can verify that the containers were created by using the command:

    sudo docker-compose ps
    Related articles
    Docker Container Volumes
    Understanding and managing Docker container volumes
    • Know-how

    Software for managing containers makes working with Linux containers significantly easier. You can not only transfer files between containers but also save files from containers. This article shows you how you can effectively manage containers using Docker container volumes, including extensive Docker volumes examples.

    Understanding and managing Docker container volumes
    Creating Docker Images
    How to create Docker images
    • Know-how

    Once you have learned the basics of working with Docker, the next step is to learn how to create and save your own images. There are two ways to create a Docker image: manually using the `docker commit` command, or automatically using a Dockerfile.

    How to create Docker images