# Troubleshooting

> Common troubleshooting issues and solutions for WordPressify.

Source: https://wordpressify.co/troubleshooting

> For the complete documentation index, see [llms.txt](https://wordpressify.co/llms.txt).

# Troubleshooting

<Accordion title="docker compose: command not found">
  **Issue:** Docker is not installed or not in your PATH.

  **Solution:** Install [Docker Desktop](/install-docker) and make sure it is running. Restart your terminal after installation.
</Accordion>

<Accordion title="Error: Docker is not running">
  **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.
</Accordion>

<Accordion title="Bind for 0.0.0.0:3010 failed: port is already allocated">
  **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.
</Accordion>

<Accordion title="403 Forbidden or 502 Bad Gateway after starting">
  **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.
</Accordion>

<Accordion title="File changes are not detected (Windows)">
  **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](/windows-installation) page for details.
</Accordion>

<Accordion title="Node.js version mismatch errors">
  **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`.
</Accordion>