
Dev Playgrounds
Where agentic WordPress development starts. Free forever, no hosting agenda.
Why Pete Panel for development?
Because development changed eras and the local tools didn’t. Every popular local WordPress tool was built for the previous era and answers to a hosting company: sealed-off environments, no real shell, an export button aimed at their servers. Pete Panel was designed for the agentic era: an environment your AI agent can safely own, answering to the developer.
Built for AI agents
Real WP-CLI, real files, real database, real logs, inside an isolated Docker container. Claude works on a full copy of your site; production never feels a thing.
Field-tested agentic workflows
One-line commands like /retheme and /reblock run entire gated migrations inside the playground. Recipes learned on real projects, encoded so they never bite twice.
Disposable by design
An agent run went sideways? Delete the playground, clone again, retry. Experiments are free when environments are.
From playground to production
Export in Pete format and deploy to any cloud you own in one click, with phpMyAdmin, multi-PHP, and VS Code Dev Containers along the way.
The agent needs a sandbox before it needs a server. See how the tools compare → See the agentic workflows →
Mac Silicon
Apple silicon · M1 / M2 / M3 / M4 / M5 · macOS · Docker Desktop
- Docker Desktop
- Git
- Clone
- .env
- Build & launch
- Code
The steps, start to finish
- Install Docker Desktop: download the Apple Silicon dmg from docker.com/products/docker-desktop, drag Docker Desktop.app into Applications, launch it once, and wait for the whale icon to turn solid (“Docker Desktop is running”).
- Install Git: open Terminal and run
xcode-select --install(Apple’s Command-Line Tools include Git). Verify withgit --version, which should print git 2.x or newer. Prefer Homebrew?brew install gitworks too. - Clone and launch: open the Terminal app and paste this single command. It creates a
Sitesfolder in your home directory, clones Pete Panel into~/Sites/pete-panel, sets up your environment file, and starts the stack:
Wait until the prompt returns and all containers are healthy.mkdir -p ~/Sites && cd ~/Sites && git clone https://github.com/peterconsuegra/wp-pete-docker.git pete-panel && cd pete-panel && cp .env.example.development .env && docker compose up --build - Launch Pete and create your first site: open
http://pete.petelocal.net/over HTTP (not HTTPS). On the first run you create your admin account, then land on the Pete Panel dashboard. Click Create WordPress Site, pick a subdomain, and Pete provisions a fresh WordPress in seconds, live at its own local address. - Code inside the container (optional, recommended): install VS Code, add the Dev Containers extension (⇧⌘X, search “Dev Containers”, Install), then click the green >< status button, choose Attach to Running Container…, pick the PHP container, and open
/var/www/html(the shared volume with all your WordPress projects).
Frequently asked questions
Why should we use Pete Panel in a development environment?
Because the upper hand in the agentic era is an environment your AI agent can safely own. Pete gives Claude an isolated, disposable dev environment with real WP-CLI, files, and database, so it can rebuild a theme, migrate off a page builder, or ship a feature on a full copy of your site, while the original never feels a thing. Work entirely in the local dev environment, or point Pete at a site running on any WordPress cloud: clone it in, hand it to the agent, and deploy when it’s right.
Do I need Docker or VirtualBox?
Docker Desktop, yes. The playground runs on Docker for consistency between your Mac and production. VirtualBox is not required. On Apple silicon, Docker Desktop’s dmg installs in one drag.
Which Macs are supported?
Apple silicon only: M1, M2, M3, M4, and M5. Intel Macs, Ubuntu, and Windows are not supported for the dev playground.
Can I migrate my existing WordPress site into the playground?
Yes, with the Pete Converter Plugin you can export your live site and bring it into Pete Panel in minutes. The same path works in reverse when you ship to production.
What does free include, exactly?
One site in the dev environment with full WP-CLI, files, and database, free forever, no credit card. Pete Panel Pro adds importing your own site, multiple sites, backups, and production deploys. See pricing →
Where are the Docker configuration commands?
In the Docker engine-room cheat-sheet below. It lists every command to shell into the php, apache, and db containers, run WP-CLI, rebuild images, restart Apache, and enter MySQL, all from ~/Sites/pete-panel.
Advanced: the Docker engine room
The playground lives where you cloned it: ~/Sites/pete-panel. Shell into the containers for WP-CLI, logs, and one-off queries.
| Task | Command (from the project folder) | When / why |
|---|---|---|
| Go to the project | cd ~/Sites/pete-panel |
The whole stack lives here. Every command below runs from this folder. |
| Start or rebuild the stack | docker compose up --build |
Builds images if they changed and launches every service in the foreground. Hit Ctrl+C to stop. |
| Open a shell in a container | docker compose exec php bash docker compose exec apache bash docker compose exec db bash |
Inspect logs, run WP-CLI, edit files quickly. |
| Rebuild after a Dockerfile edit | docker compose build --no-cache apache docker compose build --no-cache php docker compose build --no-cache db |
Forces a clean image rebuild for the service you changed. |
| Reset phpMyAdmin | docker compose down docker volume rm pete-panel_pma_data |
Drops the pma_data volume so phpMyAdmin is regenerated on the next up. |
| Restart Apache in place | docker compose exec apache apache2ctl restart |
Applies v-host changes without recreating the whole stack. |
| Where Apache keeps v-hosts | /etc/apache2/sites-available /etc/apache2/sites-enabled |
Edit in sites-available (staging), symlinked live in sites-enabled; then apache2ctl graceful inside the container. |
| Enter MySQL as root | docker compose exec db mysql -u root -p |
Password = MYSQL_ROOT_PASSWORD in .env. Handy for one-off queries or importing .sql dumps. |
| Graceful Apache reload from PHP / CI | curl -sf -H "X-Reload-Secret: $APACHE_RELOAD_SECRET" http://apache/internal-reload |
Lets a deploy script tell Apache to reload configs without restarting the container. |
| Delete all volumes | docker compose down -v |
Irreversible. Stops containers and removes every volume, databases included. Nuke-and-pave only. |
Ready to hand Claude the keys?
Spin up the playground on your Mac, run a workflow, and watch a migration happen in an afternoon. When it’s right, deploy.
