diff --git a/docs/install/docker.md b/docs/install/docker.md index b0af50ae99..63bc5cd7b9 100644 --- a/docs/install/docker.md +++ b/docs/install/docker.md @@ -96,6 +96,19 @@ Replace `ghcr.io/coder/coder:latest` in the `docker run` command in the ## Troubleshooting +### Cannot connect to the Docker daemon + +If you see an error like: + +```text +Error: Error pinging Docker server: Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running? +``` + +Docker is not installed or not running on the host. Install Docker and start the +daemon before creating a workspace from a Docker-based template. Refer to the +[quickstart troubleshooting](../tutorials/quickstart.md#cannot-connect-to-the-docker-daemon) +for platform-specific steps. + ### Docker-based workspace is stuck in "Connecting..." Ensure you have an externally-reachable `CODER_ACCESS_URL` set. See diff --git a/docs/tutorials/quickstart.md b/docs/tutorials/quickstart.md index 9a73508978..d5741c8b56 100644 --- a/docs/tutorials/quickstart.md +++ b/docs/tutorials/quickstart.md @@ -257,48 +257,69 @@ advanced capabilities that Coder offers. ## Troubleshooting -### Cannot connect to the Docker daemon on Linux +### Cannot connect to the Docker daemon + +When creating a workspace from a Docker template, you may see an error like: ```text Error: Error pinging Docker server: Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running? ``` -1. Install Docker for your system, if you haven't already done so: +This means Docker is either not installed or not running on the machine where +Coder is running. Docker must be running before you create a workspace from a +Docker-based template. + +