Troubleshooting

Issue: Docker is not installed or not in your PATH.

Solution: Install Docker Desktop and make sure it is running. Restart your terminal after installation.

Issue: Docker is installed but not running. WordPressify checks for Docker before executing any Docker command and shows this error if it is not available.

Solution: Open Docker Desktop and wait for it to fully start before retrying the command.

Issue: The default proxy port (3010) is already in use by another process.

Solution: Change the port in your .env file to a different value, e.g. PROXY_PORT=3030, and restart.

Issue: WordPress and the build tools are still initializing.

Solution: Wait 10-20 seconds for the containers to finish setting up, then reload the page.

Issue: The file watcher misses changes, so live reload does not trigger.

Solution: The watcher uses polling by default, so this should work out of the box. If changes are still not detected, make sure Docker Desktop is using the WSL 2 backend. See the Windows Installation page for details.

Issue: Your local Node.js version is incompatible with the project dependencies.

Solution: Use Node.js 12.20 or later (any current LTS release works). If you do not want to install Node.js locally, run everything through Docker with docker compose up.