Docker Compose and WordPress

Use WordPress locally with Docker using Docker compose

Contents

• A Dockerfile for extending a base image and using a custom Docker image with an automated build on Docker Hub
• PHP 8.1
• Custom domain and HTTPS support. So you can use for example https://myapp.local
• Custom nginx config in ./nginx
• Custom PHP php.ini config in ./config
• Volumes for nginx, wordpress and mariadb
• Composer - dependency manager for PHP
• Bedrock - modern development tools, easier configuration, and an improved secured folder structure for WordPress
• WP-CLI - WP-CLI is the command-line interface for WordPress.
• MailHog - An email testing tool for developers. Configure your outgoing SMTP server and view your outgoing email in a web UI.
• PhpMyAdmin - free and open source administration tool for MySQL and MariaDB
  • PhpMyAdmin config in ./config
• CLI script to create a SSL certificate using mkcert

Instructions and help

See the new Wiki

Changelog

2024-05-28

• Update Composer to use PHP 8.1
• Added a GitHub Wiki for instructions

2022-05-28

• Use PHP 8.1 Dockerfile is updated.

2022-05-28

• Use php:8.0-fpm-alpine as the base image on the image in Dockerfile

2022-05-28

• Updated the Docker image to use PHP 8

2021-08-04

• Updated to WordPress 5.8.0

2021-03-16

• Changed root .env-example to .env.example to match the git ignore patterns. Thanks @scottnunemacher

2021-03-05

• Clarify steps in the readme

2021-03-02

• Fixed a misstake so instead of ./src/.env-example, it should be ./src/.env.example.
• Redirect HTTP to HTTPS. Thanks @humblecoder

2021-01-02

• Use NGINX_ENVSUBST_TEMPLATE_SUFFIX. Use a template and better substution of ENV variables in nginx config.

2020-10-04

• Added mariadb-client (Solves #54)

2020-09-15

• Updated Bedrock. Update WordPress to 5.5.1 and other composer updates.

2020-07-12

• Added Mailhog. Thanks @mortensassi

2020-05-03

• Added nginx gzip compression

2020-04-19

• Added Windows support for creating SSH cert, trusting it and setting up the host file entry. Thanks to @styssi

2020-04-12

• Remove port number from DB_HOST. Generated database connection error in macOS Catalina. Thanks to @nirvanadev
• Add missing ENV variable from mariadb Thanks to @vonwa

2020-03-26

• Added phpMyAdmin config.Thanks to @titoffanton

2020-02-06

• Readme improvements. Explain /etc/hosts better

2020-01-30

• Use Entrypoint command in Docker Compose to replace the domain name in the nginx config. Removing the need to manually edit the domain name in the nginx conf. Now using the .env value DOMAIN
• Added APP_NAME in .env-example Thanks to @Dave3o3

2020-01-11

• Added .env support for specifying your own app name, domain etc in Docker and cli scripts.
• Added phpMyAdmin. Visit http://127.0.0.1:8080/

2019-08-02

• Added Linux support. Thanks to @faysal-ishtiaq.