WordPress Docker with Pre-installed Plugins# WordPress Docker with WP-CLI & WooCommerce# WordPress Docker with WP-CLI & WooCommerce

A clean, production-ready WordPress Docker image that uses build-time plugin installation following WordPress Docker best practices.A production-ready WordPress Docker image with JSON-driven plugin management, WP-CLI and WooCommerce CLI integration, optimized for container services.A production-ready WordPress Docker image with JSON-driven plugin management, WP-CLI and WooCommerce CLI integration, optimized for container services.

Features## Features## Features

WordPress:latest base image- WordPress:latest base image with WP-CLI- WordPress:latest base image with WP-CLI
Build-time plugin installation using WP-CLI to create ZIP files
Native WordPress initialization - no custom scripts needed- JSON-driven plugin management for easy configuration - JSON-driven plugin management for easy configuration
Environment variable configuration for all WordPress settings
Container service optimized (AWS ECS, Google Cloud Run, Azure Container Instances)- WooCommerce CLI integration for premium extensions- WooCommerce CLI integration for premium extensions

How It Works- Environment variable configuration for security- Environment variable configuration for security

This approach follows the official WordPress Docker recommendations:- Container service optimized (AWS ECS, Google Cloud Run, Azure Container Instances)- Container service optimized (AWS ECS, Google Cloud Run, Azure Container Instances)

Build Time: WP-CLI downloads plugins as ZIP files to /usr/src/wordpress/wp-content/plugins/## Quick Start## Quick Start
Runtime: WordPress native entrypoint copies files to /var/www/html and handles initialization
Configuration: All settings via standard WordPress environment variables### Basic Container Run### Basic Container Run

No custom entrypoints, no runtime scripts, no complexity - just clean WordPress!```bash````bash

Quick Startdocker build -t custom-wordpress:latest .docker build -t custom-wordpress:latest .


# Build the image

docker build -t my-wordpress .--name my-wordpress \



# Run with basic configuration-p 8080:80 \docker run -d \*\*Plugin Management:\*\*

docker run -d \

  --name wordpress \-e WORDPRESS_DB_HOST=your-db-host \

  -p 8080:80 \

  -e WORDPRESS_DB_HOST=your-db-host \-e WORDPRESS_DB_USER=your-db-user \ --name my-wordpress \

  -e WORDPRESS_DB_USER=your-db-user \

  -e WORDPRESS_DB_PASSWORD=your-db-password \-e WORDPRESS_DB_PASSWORD=your-db-password \

  -e WORDPRESS_DB_NAME=your-db-name \

  my-wordpress-e WORDPRESS_DB_NAME=your-db-name \ -p 8080:80 \- JSON-based plugin configuration (`plugins-config.json`)

custom-wordpress:latest

Pre-installed Plugins


All plugins are downloaded as ZIP files during the Docker build process and installed by WordPress on first run:



**Core Plugins:**

- WooCommerce + Stripe Gateway### With WooCommerce API Key (for premium extensions)  -e WORDPRESS_DB_USER=your-db-user \- Automatic installation using WP-CLI## What's Included**Access:**

- Contact Form 7 + Flamingo

- Performance Lab + Redis Cache

- Jetpack, TablePress, PDF Embedder

- And 40+ more essential plugins```bash  -e WORDPRESS_DB_PASSWORD=your-db-password \



See `plugins-config.json` for the complete list.docker run -d \



## Environment Variables  --name my-wordpress \  -e WORDPRESS_DB_NAME=your-db-name \- Support for WooCommerce CLI (when available)



Use standard WordPress environment variables for configuration:  -p 8080:80 \



### Database (Required)  -e WORDPRESS_DB_HOST=your-db-host \  custom-wordpress:latest

```bash

WORDPRESS_DB_HOST=your-database-host  -e WORDPRESS_DB_USER=your-db-user \

WORDPRESS_DB_USER=your-database-user

WORDPRESS_DB_PASSWORD=your-database-password  -e WORDPRESS_DB_PASSWORD=your-db-password \```- Categorized plugin groups for easy management

WORDPRESS_DB_NAME=your-database-name

```  -e WORDPRESS_DB_NAME=your-db-name \



### Optional WordPress Settings  -e WOOCOMMERCE_API_KEY=your-woocommerce-api-key \

```bash

# Site URLs (auto-detected from request if not set)  custom-wordpress:latest

WORDPRESS_CONFIG_EXTRA='define("WP_HOME", "https://yourdomain.com");'

```### With WooCommerce API Key (for premium extensions)

# File system

FS_METHOD=direct



# Redis configuration**Access:**```bash

WP_REDIS_HOST=your-redis-host

WP_REDIS_PORT=6379- WordPress: http://localhost:8080



# Multisitedocker run -d \**Core Plugins (40+ automatically installed):****Core Plugins:**- WordPress: http://localhost:8080

WORDPRESS_CONFIG_EXTRA='define("WP_ALLOW_MULTISITE", true);'

```## What's Included



## Plugin Configuration  --name my-wordpress \



Edit `plugins-config.json` to customize which plugins are pre-installed:**Core Plugins (45+ automatically installed):**



```json- **WordPress Core:** Classic Editor, Health Check, WordPress Importer  -p 8080:80 \- **WordPress Core:** Classic Editor, Health Check, WordPress Importer

{

  "plugins": [- **WooCommerce:** Core + Stripe Gateway + Extensions

    {

      "name": "WooCommerce",- **Communication:** Contact Form 7, Flamingo, MailerLite  -e WORDPRESS_DB_HOST=your-db-host \

      "slug": "woocommerce",

      "installer": "wp",- **Performance:** Performance Lab, Redis Cache, Redirection

      "activate": true,

      "required": true- **Content:** TablePress, PDF Embedder, Download Monitor  -e WORDPRESS_DB_USER=your-db-user \- **WooCommerce:** Core + Stripe Gateway + Extensions- WooCommerce + Stripe Gateway + AfterShip Tracking- phpMyAdmin: http://localhost:8081

    }

  ]- **Media/Utilities:** Big File Uploads, Font Awesome, Widget Options

}

```- **Analytics:** Jetpack, AfterShip Tracking  -e WORDPRESS_DB_PASSWORD=your-db-password \



**Plugin Types:**

- `"installer": "wp"` - WordPress.org plugins (downloaded during build)

- `"installer": "manual"` - Custom plugins (copy ZIP files to `themes/` folder)**Custom Themes:**  -e WORDPRESS_DB_NAME=your-db-name \- **Communication:** Contact Form 7, Flamingo, MailerLite



## Custom Themes- Your themes from the `themes/` folder are automatically copied



Place your custom theme ZIP files or folders in the `themes/` directory. They will be copied to WordPress during the build process.  -e WOOCOMMERCE_API_KEY=your-woocommerce-api-key \



## Container Deployment## Environment Variables



Perfect for any container service:  custom-wordpress:latest- **Performance:** Performance Lab, Redis Cache, Redirection- Contact Form 7 + Flamingo



**Requirements:**| Variable | Description | Required |

- External MySQL/MariaDB database

- Persistent volume for `/var/www/html/wp-content/uploads`|----------|-------------|----------|````

- Environment variables for database connection

| `WORDPRESS_DB_HOST` | Database hostname | Yes |

**Ports:**

- Exposes port 80| `WORDPRESS_DB_USER` | Database username | Yes |- **Content:** TablePress, PDF Embedder, Download Monitor



## File Structure| `WORDPRESS_DB_PASSWORD` | Database password | Yes |



```| `WORDPRESS_DB_NAME` | Database name | Yes |## Environment Variables

/workspaces/wp/

├── Dockerfile              # Clean build-time installation| `WOOCOMMERCE_API_KEY` | WooCommerce.com API key for premium extensions | No |

├── plugins-config.json     # Plugin definitions

└── themes/                 # Custom themes (optional)| `AUTO_INSTALL` | Set to "false" to skip plugin installation | No |- **Media/Utilities:** Big File Uploads, Font Awesome, Widget Options- Jetpack, Classic Editor, Health Check## What's Included

```

| `ACTIVATE_THEME` | Theme slug to activate on startup | No |

## Why This Approach?

| `ADDITIONAL_PLUGINS` | Comma-separated list of additional plugins | No || Variable | Description | Required |

**Benefits over runtime installation:**

- ✅ Faster container startup (no plugin downloads)

- ✅ More reliable (no network dependencies at runtime)

- ✅ Follows WordPress Docker best practices## Plugin Configuration|----------|-------------|----------|- **Analytics:** Jetpack, AfterShip Tracking

- ✅ Uses native WordPress initialization

- ✅ Cleaner, simpler architecture

- ✅ Better for container orchestration

Plugins are managed through `plugins-config.json` with the following installer types:| `WORDPRESS_DB_HOST` | Database hostname | Yes |

**Build vs Runtime:**

- **Build Time**: Download and prepare plugin ZIP files

- **Runtime**: WordPress handles everything natively

- **`wp`**: Standard WordPress.org plugins via WP-CLI| `WORDPRESS_DB_USER` | Database username | Yes |- Performance Lab, Redis Cache

## WP-CLI Commands (Optional)

- **`wp_wc_com`**: WooCommerce.com extensions via WC CLI (requires API key)

Since plugins are pre-installed, you typically won't need WP-CLI at runtime. But if needed:

- **`manual`**: Premium plugins requiring manual ZIP installation| `WORDPRESS_DB_PASSWORD` | Database password | Yes |

```bash

# Connect to running container

docker exec -it wordpress-container bash

### Example Plugin Configuration| `WORDPRESS_DB_NAME` | Database name | Yes |**Custom Themes:**

# Run WP-CLI commands (install WP-CLI first in running container if needed)

wp plugin list --path=/var/www/html

```

```json| `WOOCOMMERCE_API_KEY` | WooCommerce.com API key for premium extensions | No |

## Development vs Production

{

**Development**: Use volume mounts for live editing

```bash  "plugins": [| `AUTO_INSTALL` | Set to "false" to skip plugin installation | No |- Your themes from the `themes/` folder are automatically copied- TablePress, PDF Embedder, Download Monitor**Core Plugins:**

docker run -d \

  -v ./themes:/var/www/html/wp-content/themes \    {

  -v ./uploads:/var/www/html/wp-content/uploads \

  my-wordpress      "name": "WooCommerce Subscriptions",| `ACTIVATE_THEME` | Theme slug to activate on startup | No |

```

      "slug": "woocommerce-subscriptions",

**Production**: Everything baked into the image

```bash      "installer": "wp_wc_com",| `ADDITIONAL_PLUGINS` | Comma-separated list of additional plugins | No |- Default themes (Astra, OceanWP, GeneratePress) installed via WP-CLI

docker run -d my-wordpress

# All plugins and themes are already included      "activate": true,

```

      "required": false## Plugin Configuration- And more essential plugins

Clean, simple, and production-ready! 🚀
    }

  ]Plugins are managed through `plugins-config.json` with the following installer types:## Environment Variables

}

```- **`wp`**: Standard WordPress.org plugins via WP-CLI- WooCommerce + Stripe Gateway + AfterShip Tracking



## WooCommerce.com Extensions- **`wp_wc_com`**: WooCommerce.com extensions via WC CLI (requires API key)



To install premium WooCommerce extensions, you need a WooCommerce.com API key:- **`manual`**: Premium plugins requiring manual ZIP installation```yaml



1. Go to [WooCommerce.com My Account](https://woocommerce.com/my-account/api-keys/)### Example Plugin Configuration# WordPress Database (required)**Custom Themes:**- Contact Form 7 + Flamingo

2. Create a new API key with read permissions

3. Use the Consumer Key as the `WOOCOMMERCE_API_KEY` environment variable```json



## Container Service Deployment{WORDPRESS_DB_HOST: your-db-host



Ready for deployment to any container service:  "plugins": {



**Requirements:**    "woocommerce_com_extensions": [WORDPRESS_DB_USER: your-db-user  - Your themes from the `themes/` folder are automatically copied- Jetpack, Classic Editor, Health Check

- External MySQL/MariaDB database

- Persistent storage for `/var/www/html/wp-content/uploads`      {

- Environment variables for database connection

- Optional: WooCommerce API key for premium extensions        "name": "WooCommerce Subscriptions",WORDPRESS_DB_PASSWORD: your-db-password



**Ports:** Exposes port 80        "slug": "woocommerce-subscriptions",



## WP-CLI Commands        "installer": "wp_wc_com",WORDPRESS_DB_NAME: your-db-name- Performance Lab, Redis Cache



```bash        "activate": true,

# View installed plugins

docker exec -it container-name wp plugin list --allow-root --path="/var/www/html"        "required": false



# Install additional plugin      }

docker exec -it container-name wp plugin install plugin-name --activate --allow-root --path="/var/www/html"

    ]# WooCommerce API (recommended)**WooCommerce API:**- TablePress, PDF Embedder, Download Monitor

# WooCommerce CLI (with API key configured)

docker exec -it container-name wp wc --allow-root --path="/var/www/html"  }



# WooCommerce extension management}WOOCOMMERCE_API_KEY: "your-woocommerce-api-key"

docker exec -it container-name wp wc com extension list --allow-root --path="/var/www/html"

File Structure- Pre-configured with API key for WooCommerce CLI- And more essential plugins


/workspaces/wp/

├── Dockerfile              # Container definition# Plugin/Theme Management

├── wp-init.sh              # JSON-driven setup script

├── plugins-config.json     # Master plugin configurationTo install premium WooCommerce extensions, you need a WooCommerce.com API key:

├── custom-entrypoint.sh    # Custom entrypoint

└── themes/                 # Your custom themesAUTO_INSTALL: "true" # Enable automatic plugin installation

Go to WooCommerce.com My Account

Important: WordPress Directory Structure

Create a new API key with read permissionsACTIVATE_THEME: "theme-name" # Set default theme to activate

Critical Fix Applied: This container now correctly uses /var/www/html as the WordPress root directory for all WP-CLI operations, following the official WordPress Docker image structure. Previous versions incorrectly used /usr/src/wordpress causing deployment failures.

Use the Consumer Key as the WOOCOMMERCE_API_KEY environment variable

Directory Structure:

Source: /usr/src/wordpress (template files)ADDITIONAL_PLUGINS: "plugin1,plugin2" # Install extra plugins## Environment VariablesCustom Themes:
Runtime: /var/www/html (active WordPress installation)
WP-CLI Path: Always uses --path="/var/www/html"The container supports these WooCommerce.com extension installation commands:

Customization```bash`````

Add New Plugins:# List available extensions (requires API key)

Edit plugins-config.json
Add plugin to appropriate categorywp wc com extension list## Plugin Configuration
Set installer type ("wp", "wp_wc_com", or "manual")
Rebuild image# Install specific extension```yaml- Your themes from the themes/ folder are automatically copied

**Premium/Custom Plugins:**wp wc com extension install --extension=plugin-slug --activate

Set installer: "manual" in JSON
Install via WP Admin or WP-CLI after deployment```The plugins-config.json file defines all plugins with metadata:

Ready for enterprise container deployment! 🚀## What's Included# WordPress Database (required)

Plugin Categories (40+ plugins):````json

WordPress Core: Classic Editor, Health Check, WordPress Importer
WooCommerce: Core + Stripe Gateway + Extensions {WORDPRESS_DB_HOST: your-db-hostWooCommerce API:
WooCommerce.com: Premium extensions (with API key)
Communication: Contact Form 7, Flamingo, MailerLite "plugins": {
Performance: Performance Lab, Redis Cache, Redirection
Content: TablePress, PDF Embedder, Download Monitor "core_wordpress": [...],WORDPRESS_DB_USER: your-db-user
Media/Utilities: Big File Uploads, Font Awesome, Widget Options
Analytics: Jetpack, AfterShip Tracking "woocommerce_extensions": [...],

Custom Themes: "communication_forms": [...],WORDPRESS_DB_PASSWORD: your-db-password- Pre-configured with your API key for WooCommerce CLI

Your themes from the themes/ folder are automatically copied
Default themes (Astra, OceanWP, GeneratePress) installed via WP-CLI "performance_security": [...],

Container Service Deployment "content_management": [...],WORDPRESS_DB_NAME: your-db-name

Ready for deployment to any container service: "media_utilities": [...],

Requirements: "analytics_tracking": [...],## Environment Variables

External MySQL/MariaDB database
Persistent storage for /var/www/html/wp-content/uploads "premium_custom": [...]
Environment variables for database connection
Optional: WooCommerce API key for premium extensions },# Plugin/Theme Management

Ports: Exposes port 80 "themes": [...]

WP-CLI Commands}AUTO_INSTALL: "true" # Enable automatic plugin installation```yaml

```bash````

View installed plugins

docker exec -it container-name wp plugin list --allow-rootACTIVATE_PLUGINS: "true" # Auto-activate pluginsenvironment:

Install additional pluginPlugin Properties:

docker exec -it container-name wp plugin install plugin-name --activate --allow-root

installer: "wp" (WP-CLI), "wp_wc" (WooCommerce CLI), or "manual"ACTIVATE_THEME: "theme-name" # Set default theme AUTO_INSTALL: "true" # Enable plugin installation

WooCommerce CLI (with API key configured)

docker exec -it container-name wp wc --allow-root- activate: true/false - Auto-activate after installation

WooCommerce extension management- `required`: true/false - Mark as essential vs optional``` ACTIVATE_PLUGINS: "true" # Auto-activate plugins

docker exec -it container-name wp wc com extension list --allow-root




## File StructureReady for deployment to any container service (AWS ECS, Google Cloud Run, Azure Container Instances, etc.)## Container Service Deployment```



```**Requirements:**

/workspaces/wp/

├── Dockerfile              # Container definition- External MySQL/MariaDB database

├── wp-init.sh              # JSON-driven setup script

├── plugins-config.json     # Master plugin configuration- Persistent storage for `/var/www/html/wp-content/uploads`The image is ready for deployment to any container service (AWS ECS, Google Cloud Run, Azure Container Instances, etc.)## Commands

├── custom-entrypoint.sh    # Custom entrypoint

└── themes/                 # Your custom themes- Environment variables for database connection

Optional: WooCommerce API key for enhanced functionality

Customization

Ports: Exposes port 80Required:```bash

Add New Plugins:

Edit plugins-config.json## WP-CLI Commands- External MySQL/MariaDB database# View installed plugins
Add plugin to appropriate category
Set installer type ("wp", "wp_wc_com", or "manual")```bash- Persistent storage for /var/www/html/wp-content/uploadsdocker exec -it wp-custom wp plugin list --allow-root
Rebuild image

View installed plugins

Premium/Custom Plugins:

Set installer: "manual" in JSONdocker exec -it container-name wp plugin list --allow-root- Environment variables for database connection
Install via WP Admin or WP-CLI after deployment

Install additional plugin# Install additional plugin

Ready for enterprise container deployment! 🚀 docker exec -it container-name wp plugin install plugin-name --activate --allow-root

**Ports:**docker exec -it wp-custom wp plugin install plugin-name --activate --allow-root

WooCommerce CLI (with API key configured)

docker exec -it container-name wp wc --allow-root- Exposes port 80

View plugin installation summary# WooCommerce CLI (with your API key configured)

docker exec -it container-name wp plugin list --format=table --allow-root




## File Structure



``````bash# Stop/Start

├── Dockerfile              # Container definition

├── wp-init.sh              # JSON-driven setup script  # View installed pluginsdocker-compose down

├── plugins-config.json     # Master plugin configuration

├── custom-entrypoint.sh    # Custom entrypointdocker exec -it container-name wp plugin list --allow-rootdocker-compose up -d

└── themes/                 # Your custom themes

Customization# Install additional plugin

**Add New Plugins:**docker exec -it container-name wp plugin install plugin-name --activate --allow-root## File Structure

Edit plugins-config.json
Add plugin to appropriate category
Set installer type ("wp", "wp_wc", or "manual")
Rebuild image# WooCommerce CLI (with API key configured)```

**Premium/Custom Plugins:**docker exec -it container-name wp wc --allow-root/workspaces/wp/

Set installer: "manual" in JSON
Install via WP Admin or WP-CLI after deployment```├── Dockerfile

Ready for enterprise container deployment! 🚀├── docker-compose.yml

File Structure├── wp-init.sh # Main setup script

├── themes/ # Your custom themes


├── Dockerfile              # Main container definition```

├── wp-init.sh              # Plugin/theme setup script

├── custom-entrypoint.sh    # Custom entrypointSimple and clean! 🚀

└── themes/                 # Your custom themes

Ready for container service deployment! 🚀

Name		Name	Last commit message	Last commit date
Latest commit History 19 Commits
.devcontainer		.devcontainer
.github/workflows		.github/workflows
plugins		plugins
themes		themes
.gitignore		.gitignore
Dockerfile		Dockerfile
README.md		README.md
plugins-config.json		plugins-config.json
wp-config.php		wp-config.php

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Repository files navigation

WordPress Docker with Pre-installed Plugins# WordPress Docker with WP-CLI & WooCommerce# WordPress Docker with WP-CLI & WooCommerce

Features## Features## Features

How It Works- Environment variable configuration for security- Environment variable configuration for security

Quick Startdocker build -t custom-wordpress:latest .docker build -t custom-wordpress:latest .

Pre-installed Plugins

File Structure- Pre-configured with API key for WooCommerce CLI- And more essential plugins

Important: WordPress Directory Structure

Customization```bash`````

Container Service Deployment "content_management": [...],WORDPRESS_DB_NAME: your-db-name

WP-CLI Commands}AUTO_INSTALL: "true" # Enable automatic plugin installation```yaml

View installed plugins

Install additional pluginPlugin Properties:

WooCommerce CLI (with API key configured)

WooCommerce extension management- `required`: true/false - Mark as essential vs optional``` ACTIVATE_PLUGINS: "true" # Auto-activate plugins

Customization

View installed plugins

Install additional plugin# Install additional plugin

WooCommerce CLI (with API key configured)

View plugin installation summary# WooCommerce CLI (with your API key configured)

Customization# Install additional plugin

File Structure├── wp-init.sh # Main setup script

About

Uh oh!

Releases

Packages

Uh oh!

Languages

Lodge104/wp

Folders and files

Latest commit

History

Repository files navigation

WordPress Docker with Pre-installed Plugins# WordPress Docker with WP-CLI & WooCommerce# WordPress Docker with WP-CLI & WooCommerce

Features## Features## Features

How It Works- Environment variable configuration for security- Environment variable configuration for security

Quick Startdocker build -t custom-wordpress:latest .docker build -t custom-wordpress:latest .

Pre-installed Plugins

File Structure- Pre-configured with API key for WooCommerce CLI- And more essential plugins

Important: WordPress Directory Structure

Customization```bash`````

Container Service Deployment "content_management": [...],WORDPRESS_DB_NAME: your-db-name

WP-CLI Commands}AUTO_INSTALL: "true" # Enable automatic plugin installation```yaml

View installed plugins

Install additional pluginPlugin Properties:

WooCommerce CLI (with API key configured)

WooCommerce extension management- required: true/false - Mark as essential vs optional``` ACTIVATE_PLUGINS: "true" # Auto-activate plugins

Customization

View installed plugins

Install additional plugin# Install additional plugin

WooCommerce CLI (with API key configured)

View plugin installation summary# WooCommerce CLI (with your API key configured)

Customization# Install additional plugin

File Structure├── wp-init.sh # Main setup script

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Languages

WooCommerce extension management- `required`: true/false - Mark as essential vs optional``` ACTIVATE_PLUGINS: "true" # Auto-activate plugins

Packages