Run WordPress with nginx using Docker Compose.
Use WordPress locally with Docker using Docker compose
Dockerfile
for extending a base image and using a custom Docker image with an automated build on Docker Hub
./nginx
php.ini
config in ./config
nginx
, wordpress
and mariadb
./config
Install mkcert:
brew install mkcert
brew install nss # if you use Firefox
Both step 1. and 2. below are required:
Copy .env.example
in the project root to .env
and edit your preferences.
Example:
IP=127.0.0.1
APP_NAME=myapp
DOMAIN="myapp.local"
DB_HOST=mysql
DB_NAME=myapp
DB_ROOT_PASSWORD=password
DB_TABLE_PREFIX=wp_
Edit ./src/.env.example
to your needs. During the composer create-project
command described below, an ./src/.env
will be created.
Example:
DB_NAME='myapp'
DB_USER='root'
DB_PASSWORD='password'
# Optionally, you can use a data source name (DSN)
# When using a DSN, you can remove the DB_NAME, DB_USER, DB_PASSWORD, and DB_HOST variables
# DATABASE_URL='mysql://database_user:database_password@database_host:database_port/database_name'
# Optional variables
DB_HOST='mysql'
# DB_PREFIX='wp_'
WP_ENV='development'
WP_HOME='https://myapp.local'
WP_SITEURL="${WP_HOME}/wp"
WP_DEBUG_LOG=/path/to/debug.log
# Generate your keys here: https://roots.io/salts.html
AUTH_KEY='generateme'
SECURE_AUTH_KEY='generateme'
LOGGED_IN_KEY='generateme'
NONCE_KEY='generateme'
AUTH_SALT='generateme'
SECURE_AUTH_SALT='generateme'
LOGGED_IN_SALT='generateme'
NONCE_SALT='generateme'
cd cli
./create-cert.sh
This script will create a locally-trusted development certificates. It requires no configuration.
mkcert needs to be installed like described in Requirements. Read more for Windows and Linux
1b. Make sure your /etc/hosts
file has a record for used domains. On Windows the hosts file can be find at C:\Windows\System32\drivers\etc
. Make sure to open it with admin rights.
sudo nano /etc/hosts
Add your selected domain like this:
127.0.0.1 myapp.local
nginx/default.conf.conf
to use this simpler config (without using a cert and HTTPS)server {
listen 80;
root /var/www/html/web;
index index.php;
access_log /var/log/nginx/access.log;
error_log /var/log/nginx/error.log;
client_max_body_size 100M;
location / {
try_files $uri $uri/ /index.php?$args;
}
location ~ \.php$ {
try_files $uri =404;
fastcgi_split_path_info ^(.+\.php)(/.+)$;
fastcgi_pass wordpress:9000;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_path_info;
}
}
docker-compose.yml
to use port 80. 443 is not needed now. nginx:
image: nginx:latest
container_name: ${APP_NAME}-nginx
ports:
- '80:80'
docker-compose run composer create-project
docker-compose up
Docker Compose will now start all the services for you:
Starting myapp-mysql ... done
Starting myapp-composer ... done
Starting myapp-phpmyadmin ... done
Starting myapp-wordpress ... done
Starting myapp-nginx ... done
Starting myapp-mailhog ... done
🚀 Open https://myapp.local in your browser
PhpMyAdmin comes installed as a service in docker-compose.
🚀 Open http://127.0.0.1:8082/ in your browser
MailHog comes installed as a service in docker-compose.
🚀 Open http://0.0.0.0:8025/ in your browser
docker-compose run composer update
docker exec -it myapp-wordpress bash
Login to the container
wp search-replace https://olddomain.com https://newdomain.com --allow-root
Run a wp-cli command
You can use this command first after you've installed WordPress using Composer as the example above.
You can, but I recommend to use Composer for this only. But to enable this edit ./src/config/environments/development.php
(for example to use it in Dev)
Config::define('DISALLOW_FILE_EDIT', false);
Config::define('DISALLOW_FILE_MODS', false);
When making changes to the Dockerfile, use:
docker-compose up -d --force-recreate --build
Login to the docker container
docker exec -it myapp-wordpress bash
Stop
docker-compose stop
Down (stop and remove)
docker-compose down
Cleanup
docker-compose rm -v
Recreate
docker-compose up -d --force-recreate
Rebuild docker container when Dockerfile has changed
docker-compose up -d --force-recreate --build
.env-example
to .env.example
to match the git ignore patterns. Thanks @scottnunemacher
./src/.env-example
, it should be ./src/.env.example
.NGINX_ENVSUBST_TEMPLATE_SUFFIX
. Use a template and better substution of ENV variables in nginx config.DB_HOST
. Generated database connection error in macOS Catalina. Thanks to @nirvanadev
/etc/hosts
betterEntrypoint
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
.env-example
Thanks to @Dave3o3
.env
support for specifying your own app name, domain etc in Docker and cli scripts.