Search code examples
ddev

I did a "ddev start" and see "web service unhealthy" and "web service health check timed out"


I was working away on a ddev project that previously worked and now I can't get it going. ddev list shows "web service unhealthy" and ddev start shows "web service health check timed out". How can I debug this?


Solution

  • The quickest way to understand what's up with the web container is to use ddev logs, see How can I find out what's going wrong with a ddev container, or see the logs?

    Most often these are the causes of web container timeout:

    • Custom configuration. When debugging, please start out by removing any custom configuration from .ddev - custom nginx and php configuration, or .ddev/web-build/Dockerfile* are highly likely to be the problem.
    • Inadequate docker resources. If you're running a few sites or have other things going on with docker, you'll want to raise the available memory from the default 2GB.