🔧 What’s Inside This Stack?#

This setup ships with:

• ✅ WordPress + WP-CLI support
• ✅ Auto plugin installation via .env
• ✅ Seamless MariaDB setup or external DB compatibility
• ✅ Lightweight base image: php-docker-nginx:php82
• ✅ Multi-arch support (ARM64, AMD64)

💻 Supported Platforms#

Run it confidently on:

• Apple Silicon (M1/M2)
• AWS Graviton instances
• Intel/AMD-based servers and desktops

📂 Project Setup#

services:
  wordpress:
    image: ghcr.io/nooblk-98/wordpress-docker:php82
    container_name: ${PROJECT_NAME}
    environment:
      WP_SITE_TITLE: ${WP_SITE_TITLE}
      WP_ADMIN_USER: ${WP_ADMIN_USER}
      WP_ADMIN_PASSWORD: ${WP_ADMIN_PASSWORD}
      WP_ADMIN_EMAIL: ${WP_ADMIN_EMAIL}
      WORDPRESS_DB_HOST: ${MYSQL_HOST}
      WORDPRESS_DB_NAME: ${MYSQL_DATABASE}
      WORDPRESS_DB_USER: ${MYSQL_USER}
      WORDPRESS_DB_PASSWORD: ${MYSQL_PASSWORD}
      WP_PLUGINS: ${WP_PLUGINS}
      WORDPRESS_DEBUG: false
    volumes:
      - web_data:/var/www/html
    ports:
      - "8080:80"
    depends_on:
      - mariadb

  mariadb:
    image: mariadb:10
    container_name: ${PROJECT_NAME}-db
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
      MYSQL_DATABASE: ${MYSQL_DATABASE}
      MYSQL_USER: ${MYSQL_USER}
      MYSQL_PASSWORD: ${MYSQL_PASSWORD}
    volumes:
      - db_data:/var/lib/mysql

volumes:
  db_data:
  web_data:

⚙️ Configure Environment Variables#

cp .env_example .env

Edit .env:

PROJECT_NAME=wordpress
MYSQL_DATABASE=wordpress_database
MYSQL_USER=wordpress_user
MYSQL_PASSWORD=YW08dsm0XP2cek6f
MYSQL_ROOT_PASSWORD=lb9tjjGGHTIvZZr6
MYSQL_HOST=mariadb

WP_SITE_TITLE=My WordPress
WP_ADMIN_USER=admin
WP_ADMIN_PASSWORD=secureAdmin123
WP_ADMIN_EMAIL=[email protected]

WP_PLUGINS="advanced-custom-fields all-in-one-wp-migration"

Deploy (Internal MariaDB)#

docker compose up --build -d

Once deployed:

• WordPress is auto-installed
• Plugins from .env are installed
• Setup is skipped on reboot (via .wp-init-done)

🔗 Visit: http://localhost:8080

🌐 Use an External Database#

Want to connect to an external MySQL/MariaDB service?

1. Set these in .env:

MYSQL_HOST=db.myhost.com
MYSQL_DATABASE=external_db
MYSQL_USER=wp_user
MYSQL_PASSWORD=securepass

2. Comment out the mariadb section in docker-compose.yml.

3. Start just the WordPress service:

docker compose up --build -d wordpress

Features at a Glance#

🔍 Environment Variables Reference#

Manage Plugins via .env#

To add or change plugins:

WP_PLUGINS="seo-by-rank-math woocommerce"

They’ll be automatically installed and activated during the first boot.

🤝 Contribute & Feedback#

Found a bug or want to suggest improvements? Contributions welcome!