Docker Compose para WordPress + MariaDB

Levantar WordPress en local es una de las cosas para las que Docker Compose brilla: en un par de minutos tienes WordPress y su base de datos sin tocar tu sistema. Esta guía monta WordPress con MariaDB y se centra en dos cosas que la gente acaba lamentando si las ignora: los volúmenes y el error de conexión a la base de datos.

compose.yaml de WordPress + MariaDB

services:
  wordpress:
    image: wordpress:6-php8.3-apache
    restart: unless-stopped
    ports:
      - "127.0.0.1:8080:80"
    environment:
      WORDPRESS_DB_HOST: "mariadb:3306"
      WORDPRESS_DB_NAME: ${MARIADB_DATABASE}
      WORDPRESS_DB_USER: ${MARIADB_USER}
      WORDPRESS_DB_PASSWORD: ${MARIADB_PASSWORD}
    volumes:
      - wordpress_data:/var/www/html
    depends_on:
      mariadb:
        condition: service_healthy
  mariadb:
    image: mariadb:11
    restart: unless-stopped
    environment:
      MARIADB_DATABASE: ${MARIADB_DATABASE}
      MARIADB_USER: ${MARIADB_USER}
      MARIADB_PASSWORD: ${MARIADB_PASSWORD}
      MARIADB_ROOT_PASSWORD: ${MARIADB_ROOT_PASSWORD}
    volumes:
      - mariadb_data:/var/lib/mysql
    healthcheck:
      test: ["CMD-SHELL", "healthcheck.sh --connect --innodb_initialized"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 20s

volumes:
  wordpress_data:
  mariadb_data:

El .env.example:

MARIADB_DATABASE=wordpress
MARIADB_USER=wordpress
MARIADB_PASSWORD=CHANGE_ME
MARIADB_ROOT_PASSWORD=CHANGE_ME

Levántalo con docker compose up -d y abre http://localhost:8080 para el instalador de WordPress.

Dos volúmenes, dos cosas que persistir

Es fácil acordarse del volumen de la base de datos y olvidar el de WordPress. Necesitas los dos:

• mariadb_data guarda la base de datos: entradas, páginas, usuarios, opciones y configuración.
• wordpress_data guarda los archivos en /var/www/html: el núcleo de WordPress, los plugins y temas que instales y, sobre todo, tus subidas en wp-content/uploads.

Si te faltara wordpress_data, perderías las imágenes subidas aunque la base de datos quedara intacta: las entradas apuntarían a archivos que ya no existen.

"Error establishing a database connection"

Es el mensaje que más asusta y casi siempre es una de estas tres causas:

• Host equivocado. WORDPRESS_DB_HOST debe ser mariadb:3306, el nombre del servicio, no localhost.
• Credenciales que no coinciden. El usuario, la contraseña y el nombre de base de datos de WordPress deben ser los mismos que los de MariaDB. Por eso ambos servicios leen las mismas variables del .env.
• MariaDB aún no estaba lista. El healthcheck de MariaDB (healthcheck.sh --connect --innodb_initialized) más depends_on: condition: service_healthy hacen que WordPress espere a que la base de datos acepte conexiones, lo que evita el fallo en el primer arranque.

Reiniciar y empezar de cero

docker compose ps                 # ¿están healthy?
docker compose logs -f wordpress  # logs del instalador
docker compose down               # para (datos a salvo)
docker compose down -v            # borra DB y archivos de WordPress

Recuerda que down -v aquí borra los dos volúmenes: pierdes la base de datos y tus uploads. Es lo que quieres para reinstalar limpio, no para un mantenimiento rutinario.

Local, no producción

Este stack es para desarrollar y probar en tu equipo. No es un despliegue endurecido: un WordPress de cara a Internet necesita HTTPS, backups de la base de datos y de los uploads, contraseñas fuertes fuera de git, y actualizaciones constantes de WordPress y sus plugins. Trátalo como un sitio de pruebas desechable.

Siguientes pasos

Genera este stack en el generador de Docker Compose y vuelve al índice de ejemplos para ver otros stacks.