WPDC - Wordpress Docker Compose
Easy Wordpress development with Docker and Docker Compose
Starting a new project
Make sure you have the latest versions of Docker and Docker Compose installed on your machine. Copy the files from this repository into a blank folder. In the docker-compose.yml file you may change the IP address (in case you run multiple containers) or the database from mysql to mariadb.
Make sure to add your user to the docker group when using linux: https://docs.docker.com/install/linux/linux-postinstall/#manage-docker-as-a-non-root-user
Open a terminal and cd to the folder you have the docker-compose.yml and run:
This create 2 new folders beside your docker-compose.yml file.
- wp-data - used to store and restore database dumps
- wp-app - the location of your Wordpress application
The containers are now build and running. You should be able to access the Wordpress installation with the configured IP in the browser address. For convenience you may add a new entry into your hosts file.
You can start the containers with the up command in daemon mode (by adding -d as a param) or by using the start command:
To stop and remove all the containers use the down command
Use -v if you need to remove the database volume which is used to persist the database:
docker-compose down -v
Project from existing source
Copy the docker-compose.yml file into a new directory. In the directory you create two folders:
- wp-data - here you add the database dump
- wp-app - here you copy your existing wordpress code
You can now use the up command:
This will create the containers and populate the database with the given dump. You may set your host entry and change it in the database, or you simply overwrite it in the wp-config.php by adding
Creating database dumps
Developing a Theme
Configure the volume to load the theme in the container in the docker-compose.yml
volumes: - ./theme-name/trunk/:/var/www/html/wp-content/themes/theme-name
Developing a Plugin
Configure the volume to load the plugin in the container in the docker-compose.yml
volumes: - ./plugin-name/trunk/:/var/www/html/wp-content/plugins/plugin-name
The docker compose configuration also provides a service for using the Wordpress CLI.
docker-compose run --rm wpcli plugin list
For an easier usage you may consider adding an alias for the CLI:
alias wp="docker-compose run --rm wpcli"
This way you can use the CLI command above as follows:
wp plugin list