/docker-wordpress

Docker Compose setup for easy and portable WordPress local development. Pre-configured WordPress, MySQL 5.7, and phpMyAdmin services. WordPress and database data are stored locally for easy management and portability.

WordPress Docker Local Development Environment (English)

This project provides a Docker Compose setup to run a WordPress local development environment easily and portably.

✨ Key Features

  • Portable: The entire environment, including WordPress files and the MySQL database, is stored within the project folder (./www/ for WordPress, ./data/ for the database). This makes it easy to create backups, share the environment, or move it between different machines.
  • Isolated: Uses Docker to ensure the development environment does not interfere with other local or system configurations.
  • Easy to Use: Start all services with a simple command (docker-compose up -d) and stop them with (docker-compose down).
  • phpMyAdmin Included: Easily access the database through phpMyAdmin for visual management.
  • Pre-configured: A ready-to-use WordPress environment with a basic setup.

📋 Prerequisites

Ensure you have installed:

📁 Project Structure

  • docker-compose.yml: Main Docker Compose configuration file that defines the services (WordPress, MySQL, phpMyAdmin).
  • ./data/: Contains the MySQL database files. This folder is created by Docker when starting the services and is ignored by Git thanks to the .gitignore file.
  • ./www/: Contains WordPress core files, themes, plugins, and uploaded files. This folder is created by Docker and is also ignored by Git.
  • ./apache-config.conf: Additional configuration file for Apache (used by WordPress and phpMyAdmin containers, e.g., for ServerName).
  • .gitignore: Specifies files and folders that Git should ignore (like ./data/ and ./www/).

🚀 Usage

  1. Clone the Repository: The simplest way is to clone the repository. This will create a new directory named docker-wordpress with the project files:

    git clone https://github.com/raulfg/docker-wordpress.git
cd docker-wordpress

    Alternative: Clone into a specific folder If you prefer to name your project folder differently or clone into an existing directory: a. Create your desired project folder (e.g., my-wordpress-project) and navigate into it:

    mkdir my-wordpress-project
cd my-wordpress-project

    b. Then, clone the repository content directly into this folder using a . at the end of the command:

    git clone https://github.com/raulfg/docker-wordpress.git .

    If you are not cloning, simply ensure you have docker-compose.yml and apache-config.conf in your working directory.

  2. Start the Services: Navigate to the project's root directory (where the docker-compose.yml file is located) and run:

    docker-compose up -d

    This will download the necessary Docker images (if it's the first time) and create and start the containers in the background (-d). If you prefer to see the container logs directly in your terminal (foreground mode), you can omit the -d flag: docker-compose up. To stop the services when running in foreground mode, press Ctrl+C in the terminal. Note that this only stops the containers; to remove them, you'll still need to run docker-compose down afterwards.

  3. Access the Services:

    • WordPress: Open your browser and go to http://localhost (or http://localhost:80).
      • The first time, you will be guided through the WordPress installation process.
      • Use the following database connection details during WordPress installation (these are defined in docker-compose.yml):
        • Database Name: wordpress
        • User: wordpress
        • Password: wordpress
        • Database Host: db (this is the name of the database service in docker-compose.yml)
        • Table Prefix: dockwp_ (pre-configured in docker-compose.yml)
    • phpMyAdmin: Open your browser and go to http://localhost:8080.
      • Server: db
      • User: root
      • Password: password (this is the MYSQL_ROOT_PASSWORD defined in docker-compose.yml)

  4. Stop and Remove the Services: To stop and remove all containers, networks, and volumes (not the locally mapped ones in ./data/ and ./www/) associated with this project, run in the same directory:

    docker-compose down

    This command is used whether you started the services with docker-compose up -d (detached mode) or if you ran them in foreground mode and stopped them with Ctrl+C. It ensures a clean shutdown and removal of the Docker resources created by this project. The data in ./data/ (database) and ./www/ (WordPress files) will persist on your local system.

🔧 Customization

You can customize the configuration by editing the docker-compose.yml file:

  • Database Credentials: Modify the MYSQL_ROOT_PASSWORD, MYSQL_DATABASE, MYSQL_USER, MYSQL_PASSWORD environment variables under the db service. Remember to also update the WORDPRESS_DB_USER, WORDPRESS_DB_PASSWORD variables in the wordpress service.
  • WordPress/MySQL/phpMyAdmin Versions: Change the image tags (e.g., wordpress:latest, mysql:5.7, phpmyadmin/phpmyadmin:latest).
  • Ports: Adjust port mappings if you have conflicts. For example, if port 8080 is already in use, you can change 8080:80 to 8081:80 for phpMyAdmin. The same applies to WordPress port 80.

Note on Environment Variables and .env File

This setup uses generic credentials directly in the docker-compose.yml file to simplify the startup of a local development environment. A separate .env file for environment variables is not used to keep the configuration as straightforward as possible for this purpose. If you need greater security or credential customization for a production or shared environment, consider adapting the configuration to use an .env file.

🙏 Acknowledgements

Special thanks to Oscar García (@opobla) for introducing me to the power of Docker.

Enjoy your portable and easy-to-manage local WordPress development environment!

Entorno de Desarrollo Local de WordPress con Docker (Español)

Este proyecto proporciona una configuración de Docker Compose para ejecutar un entorno de desarrollo local de WordPress de forma sencilla y portable.

✨ Características Principales

  • Portable: Todo el entorno, incluyendo los archivos de WordPress y la base de datos MySQL, se almacena dentro de la carpeta del proyecto (./www/ para WordPress, ./data/ para la base de datos). Esto facilita la creación de copias de seguridad, compartir el entorno o moverlo entre diferentes máquinas.
  • Aislado: Utiliza Docker para asegurar que el entorno de desarrollo no interfiera con otras configuraciones locales o del sistema.
  • Fácil de Usar: Inicia todos los servicios con un simple comando (docker-compose up -d) y detenlos con (docker-compose down).
  • phpMyAdmin Incluido: Accede fácilmente a la base de datos a través de phpMyAdmin para una gestión visual.
  • Pre-configurado: Un entorno de WordPress listo para usar con una configuración básica.

📋 Requisitos Previos

Asegúrate de tener instalados:

📁 Estructura del Proyecto

  • docker-compose.yml: Archivo principal de configuración de Docker Compose que define los servicios (WordPress, MySQL, phpMyAdmin).
  • ./data/: Contiene los archivos de la base de datos MySQL. Esta carpeta es creada por Docker al iniciar los servicios y está ignorada por Git gracias al archivo .gitignore.
  • ./www/: Contiene los archivos del núcleo de WordPress, temas, plugins y archivos subidos. Esta carpeta es creada por Docker y también está ignorada por Git.
  • ./apache-config.conf: Archivo de configuración adicional para Apache (utilizado por los contenedores de WordPress y phpMyAdmin, por ejemplo, para ServerName).
  • .gitignore: Especifica los archivos y carpetas que Git debe ignorar (como ./data/ y ./www/).

🚀 Uso

  1. Clonar el Repositorio: La forma más sencilla es clonar el repositorio. Esto creará un nuevo directorio llamado docker-wordpress con los archivos del proyecto:

    git clone https://github.com/raulfg/docker-wordpress.git
cd docker-wordpress

    Alternativa: Clonar en una carpeta específica Si prefieres nombrar la carpeta de tu proyecto de manera diferente o clonar en un directorio existente: a. Crea la carpeta de proyecto deseada (por ejemplo, mi-proyecto-wordpress) y navega hacia ella:

    mkdir mi-proyecto-wordpress
cd mi-proyecto-wordpress

    b. Luego, clona el contenido del repositorio directamente en esta carpeta usando un . al final del comando:

    git clone https://github.com/raulfg/docker-wordpress.git .

    Si no vas a clonar, simplemente asegúrate de tener docker-compose.yml y apache-config.conf en tu directorio de trabajo.

  2. Iniciar los Servicios: Navega al directorio raíz del proyecto (donde se encuentra el archivo docker-compose.yml) y ejecuta:

    docker-compose up -d

    Esto descargará las imágenes de Docker necesarias (si es la primera vez) y creará e iniciará los contenedores en segundo plano (-d). Si prefieres ver los logs de los contenedores directamente en tu terminal (modo primer plano), puedes omitir el parámetro -d: docker-compose up. Para detener los servicios cuando se ejecutan en modo primer plano, presiona Ctrl+C en la terminal. Ten en cuenta que esto solo detiene los contenedores; para eliminarlos, necesitarás ejecutar docker-compose down después.

  3. Acceder a los Servicios:

    • WordPress: Abre tu navegador y ve a http://localhost (o http://localhost:80).
      • La primera vez, serás guiado a través del proceso de instalación de WordPress.
      • Utiliza las siguientes credenciales para la conexión a la base de datos durante la instalación de WordPress (estas están definidas en docker-compose.yml):
        • Nombre de la base de datos: wordpress
        • Usuario: wordpress
        • Contraseña: wordpress
        • Host de la base de datos: db (este es el nombre del servicio de la base de datos en docker-compose.yml)
        • Prefijo de tabla: dockwp_ (preconfigurado en docker-compose.yml)
    • phpMyAdmin: Abre tu navegador y ve a http://localhost:8080.
      • Servidor: db
      • Usuario: root
      • Contraseña: password (es la MYSQL_ROOT_PASSWORD definida en docker-compose.yml)

  4. Detener y Eliminar los Servicios: Para detener y eliminar todos los contenedores, redes y volúmenes (no los mapeados localmente en ./data/ y ./www/) asociados a este proyecto, ejecuta en el mismo directorio:

    docker-compose down

    Este comando se utiliza tanto si iniciaste los servicios con docker-compose up -d (modo segundo plano) como si los ejecutaste en modo primer plano y los detuviste con Ctrl+C. Asegura una detención y eliminación limpias de los recursos Docker creados por este proyecto. Los datos en ./data/ (base de datos) y ./www/ (archivos de WordPress) persistirán en tu sistema local.

🔧 Personalización

Puedes personalizar la configuración editando el archivo docker-compose.yml:

  • Credenciales de la Base de Datos: Modifica las variables de entorno MYSQL_ROOT_PASSWORD, MYSQL_DATABASE, MYSQL_USER, MYSQL_PASSWORD bajo el servicio db. Recuerda actualizar también las variables WORDPRESS_DB_USER, WORDPRESS_DB_PASSWORD en el servicio wordpress.
  • Versión de WordPress/MySQL/phpMyAdmin: Cambia las etiquetas de las imágenes (ej. wordpress:latest, mysql:5.7, phpmyadmin/phpmyadmin:latest).
  • Puertos: Ajusta los mapeos de puertos si tienes conflictos. Por ejemplo, si el puerto 8080 ya está en uso, puedes cambiar 8080:80 a 8081:80 para phpMyAdmin. Lo mismo aplica para el puerto 80 de WordPress.

Nota sobre Variables de Entorno y Archivo .env

Esta configuración utiliza credenciales genéricas directamente en el archivo docker-compose.yml para simplificar la puesta en marcha de un entorno de desarrollo local. No se utiliza un archivo .env separado para las variables de entorno con el fin de mantener la configuración lo más directa posible para este propósito. Si necesitas una mayor seguridad o personalización de las credenciales para un entorno de producción o compartido, considera adaptar la configuración para usar un archivo .env.

🙏 Agradecimientos

Un agradecimiento especial a Oscar García (@opobla) por darme a conocer el poder de Docker.

¡Disfruta de tu entorno de desarrollo local de WordPress portable y fácil de gestionar!