WordPress Demo

Blank WordPress-in-Docker environment for testing theme/plugin zip installs: no project theme bind mounts, no seeded content, no custom setup script.

First run

cp .env.example .env
make setup

Defaults:

• Site: http://localhost:18181
• Admin: http://localhost:18181/wp-admin/
• User: admin
• Password: password
• Mailpit: http://localhost:8026
• Theme/plugin upload limit: 128M

Override credentials when installing if desired:

make setup ADMIN_USER=demo ADMIN_PASSWORD='change-me' ADMIN_EMAIL=demo@example.test

Install a theme zip

From the theme project, build the handoff zip. Then from this directory:

make install-theme ZIP=/absolute/path/to/theme.zip
make activate-theme SLUG=theme-slug

Or upload the zip through WordPress admin:

1. Appearance -> Themes -> Add New -> Upload Theme
2. Choose the zip
3. Install and Activate

Useful commands

make wp CMD='theme list'
make wp CMD='plugin list'
make sync-url
make logs
make down
make reset   # destructive: removes database and WordPress volumes
make fresh   # destructive: wipe volumes, start, and reinstall WordPress

For a clean demo take, use:

make fresh

After changing PHP settings, recreate the containers:

make restart

Notes

• uploads/ is mounted only as a convenient host-side drop zone for zip files or test media. It is not mapped into WordPress content.
• Use a unique COMPOSE_PROJECT_NAME in .env if you want multiple demo stacks.