See troubleshooting for more detailed problem-solving. If you’re using another local development environment (like Lando or Docksal or a native setup), you can either stop the other environment or configure DDEV to use different ports. Using DDEV with Other Development EnvironmentsĭDEV uses your system’s port 80 and 443 by default when projects are running. Try the simplest possible DDEV project (just as ddev debug test does): Consider a Docker factory reset in serious cases, which will destroy any databases you’ve loaded.

It’s important to have the simplest possible environment while troubleshooting. If you have customizations like PHP overrides, nginx or Apache overrides, MySQL/PostgreSQL overrides, custom services, or config.yaml changes, please back them out while troubleshooting.If it says zero used, something is wrong. In Settings (or Preferences) → Resources → Disk image size there should be ample space left try not to let usage exceed 80% because the reported number can be unreliable. On macOS, check to make sure Docker Desktop or Colima are not out of disk space.Use ddev debug dockercheck and ddev debug test to help sort out Docker problems.Temporarily disable any proxies you’ve established in Docker’s settings.Temporarily disable firewalls, VPNs, network proxies, and virus checkers while you’re troubleshooting.Start by running ddev poweroff to make sure all containers can start fresh.Things might go wrong! In addition to this page, consider checking Stack Overflow and the DDEV issue queue and other support options, as well as Docker troubleshooting suggestions. Debugging & Profiling Debugging & Profiling.In-Container Home Directory and Shell Configuration.Defining Additional Services with Docker Compose.Additional Service Configurations & Add-ons.Limitations on Symbolic Links (symlinks).Windows Hosts File Limited to 10 Hosts Per Line.DDEV Starts but Browser Can’t Access URL.ddev start Fails with 'Failed to start : No such container: ddev-router'.ddev start Fails with 'container failed to become ready'.

ddev start Fails and Logs Contain 'failed (28: No space left on device)' - Docker File Space.

No Input File Specified (404) or Forbidden (403).

“web service unhealthy” or “web service starting” or Exited.

Troubleshooting Troubleshooting Table of contents.

Multiple localhost running tcpview