~ / hub / erros / Cannot connect to the Docker daemon
4 out 2026errosguia de solução

Cannot connect to the Docker daemon

O cliente docker não fala com o serviço. Serviço parado, permissão ou contexto.

1. Significado

Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?

O comando docker é só um cliente. Ele conversa com o daemon (dockerd) por um socket. O erro indica que o daemon não está rodando, ou que você não tem permissão de acessar esse socket.

2. O serviço está ativo? (Linux)

sudo systemctl status docker
sudo systemctl start docker
sudo systemctl enable docker      # iniciar automaticamente no boot
sudo journalctl -u docker -n 50 --no-pager

Se falhar ao iniciar, o log costuma mostrar o motivo (arquivo daemon.json inválido, disco cheio, conflito de rede). Veja systemctl e journalctl.

3. É permissão? Sintoma: "permission denied"

# Se a mensagem trouxer "permission denied while trying to connect..."
sudo usermod -aG docker $USER
newgrp docker          # ou faça logout/login para valer em todas as sessões
docker ps

Quem está no grupo docker tem poder equivalente ao root na máquina. Em servidores compartilhados, avalie o modo rootless ou o Podman.

4. Windows e macOS

  • Abra o Docker Desktop e aguarde ele indicar que está em execução; o daemon fica dentro de uma VM e demora para subir.
  • No Windows com WSL 2, confirme que a integração com a distribuição está ativada nas configurações e que o WSL está atualizado (wsl --update).
  • Se o Docker Desktop travar na inicialização, reiniciar o aplicativo (ou o WSL com wsl --shutdown) costuma resolver.

5. Contexto ou variável de ambiente apontando para outro lugar

docker context ls          # qual contexto está ativo?
docker context use default
echo $DOCKER_HOST          # se estiver definido, pode apontar para um host inexistente
unset DOCKER_HOST
DICA Teste sempre com docker version: ele mostra separadamente Client e Server. Se o bloco Server falhar, o problema é o daemon.

Continue explorando

← erros · docker · systemctl · Termo: Docker · Curso de Docker

Veja também o hub de conteúdo, o glossário e os cursos gratuitos.

Quer aplicar no seu time?

Diagnóstico gratuito de 30 minutos.

solicitar →