"Cannot connect to the Docker daemon" is usually caused by Docker not running, insufficient permissions or socket file problems. 1. Check whether the Docker service is running, use systemctl status docker or service docker status. If it is not running, execute sudo systemctl start docker and enable boot; 2. Confirm whether the user has joined the docker group. If it is not joined, use sudo usermod -aG docker $USER to add and log in again; 3. Check whether /var/run/docker.sock exists and is configured correctly to ensure that the environment variable DOCKER_HOST does not point to the wrong host; 4. Troubleshoot system-specific problems such as WSL2 integration, macOS restart Docker Desktop or cloud instance dependency issues, and reinstall Docker if necessary.

If you're seeing the error "Cannot connect to the Docker daemon," it usually means Docker isn't running, or your user doesn't have permission to access it. It's a common issue, especially if you just installed Docker or are switching between users or environments.

Check if the Docker service is running

The most basic and often overlooked step: make sure the Docker daemon is actually up and running. On Linux systems, Docker runs as a background service. If it's not started, nothing will work.

You can check its status with:

 systemctl status docker

If it shows something like "inactive (dead)," then you need to start it manually:

 sudo systemctl start docker

And if you want it to launch automatically on boot:

 sudo systemctl enable docker

• Not all systems use systemctl — older versions might use service docker status instead.
• On macOS or Windows with Docker Desktop, make sure the app is launched and fully initialized before running commands.

Permissions issues – Are you in the Docker group?

By default, Docker requires root privileges unless your user has been added to the docker group. If you run a Docker command without proper permissions, you'll get that same connection error.

To fix this, first check whether the docker group exists and whether your user is part of it:

 groups

If you don't see docker listed, add yourself:

 sudo usermod -aG docker $USER

After doing this, log out and back in for the group changes to take effect.

?? Warning: Being in the docker group effectively grants root-level access, so only trusted users should be added here.

Connection issues – Socket file problems

Docker uses a Unix socket ( /var/run/docker.sock ) to communicate with clients. If that file is missing or misconfigured, you'll hit the same error.

Check if the socket exists:

 ls -l /var/run/docker.sock

If it's missing:

• Restarting the Docker service might bring it back.
• If not, there could be a deeper configuration or filesystem issue.

Also, verify that your environment isn't pointing to a wrong or remote Docker host by mistake:

 echo $DOCKER_HOST

If that returns something unexpected, clear it:

 unset DOCKER_HOST

System-specific gotchas

Some platforms behave differently and may cause confusion:

• On WSL2 (Windows Subsystem for Linux): Docker Desktop integrates with WSL2, but sometimes the integration breaks. Make sure Docker Desktop is running on Windows and properly configured to work with your WSL distro.
• On macOS: If you're using Docker Desktop, restart the app or try resetting to factory defaults via the Docker menu.
• On cloud instances (like AWS EC2): After rebooting, Docker may not auto-start due to failed dependencies or disk issues. Rebooting again or cleaning logs can help.

Sometimes, reinstalling Docker cleanly helps when things get too messy:

 sudo apt purge docker docker-engine docker.io containerd runc
sudo apt install docker.io

(Or use the official Docker installation script if preferred.)

That's about it. Most "Cannot connect to the Docker daemon" errors boil down to service state, permissions, or socket problems. Fixing one of those usually gets you back on track.

The above is the detailed content of How do you troubleshoot 'Cannot connect to the Docker daemon'?. For more information, please follow other related articles on the PHP Chinese website!