Tutoriais de VPS
Cannot connect to Docker daemon no VPS: serviço e context (2026)
Confirme endpoint, diferencie Docker do sistema e rootless e veja logs/configuração antes de validar contêineres e volumes originais.

Se docker ps, docker compose up ou deploy mostra Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?, não comece reinstalando. O cliente não conectou ao daemon selecionado: serviço parado, endpoint errado, mistura rootless/sistema ou configuração inválida.
O guia cobre VPS Linux com systemd: destino, serviço/logs, causa e negócio original. Desktop, Kubernetes e runtimes independentes do painel exigem gestão própria.
| Erro/endereço | Investigar |
|---|---|
Cannot connect ... unix:///var/run/docker.sock | Daemon do sistema e socket |
/run/user/1000/docker.sock | Rootless do usuário e sessão |
tcp://... / ssh://... | Context, ambiente e remoto |
permission denied while trying to connect | Permissão/identidade, não necessariamente serviço parado |
docker.service: Failed / Start request repeated too quickly | Primeira falha real do journal |
Unit docker.service could not be found | Só CLI ou outra instalação |
docker --version comprova CLI. docker version separa Client e falha Server. Veja daemon.
Use mesmo usuário e terminal:
docker version
docker context show
docker context ls
docker context inspect
env | grep -E '^DOCKER_(HOST|CONTEXT|TLS_VERIFY|CERT_PATH)='
Ambiente vazio costuma significar variáveis não definidas. Confira endpoint/erro. DOCKER_HOST, DOCKER_CONTEXT, --host e --context influenciam; estrela docker context ls não basta. Veja contexts.
Se remoto é intencional, confira host/SSH/TLS sem mudar para local. Para Engine local do sistema, compare um comando:
env -u DOCKER_HOST -u DOCKER_CONTEXT -u DOCKER_TLS_VERIFY -u DOCKER_CERT_PATH docker --context default info
Remove variáveis relevantes e escolhe default somente aqui. Se funcionar, corrija origem em script/shell/CI. Preserve outros ajustes/contexts usados. sudo docker ... e usuário comum podem ler contas diferentes; sucesso com sudo não comprova mesmo daemon.
Para Engine do sistema:
sudo systemctl status docker.service docker.socket --no-pager -l
sudo systemctl is-active docker.service
sudo journalctl -u docker.service -b --no-pager -n 100
sudo ls -l /var/run/docker.sock
Socket existente não comprova resposta. Confirme /var/run/docker.sock e teste:
sudo env -u DOCKER_HOST -u DOCKER_CONTEXT -u DOCKER_TLS_VERIFY -u DOCKER_CERT_PATH docker --host unix:///var/run/docker.sock info
Se funciona, mas usuário recebe permission denied no mesmo socket, veja permissões/grupos. Não use chmod 666 /var/run/docker.sock: acesso permite controle privilegiado do host.
Com Engine correto e sem erros de dados/configuração:
sudo systemctl start docker.service
sudo systemctl is-active docker.service
Veja inicialização. Se falhar, leia logs sem repetir continuamente.
Confira CLI e daemon:
command -v docker
command -v dockerd
systemctl list-unit-files 'docker*' 'containerd*'
docker não instala Engine. Rootless, Snap, binários e painel podem usar outra gestão. Use origem real sem empilhar pacotes conflitantes. Improvisar docker.service complica socket, containerd e argumentos.
Veja logs completos e unit efetivo:
sudo journalctl -u docker.service -b --no-pager -n 200
sudo systemctl cat docker.service
sudo systemctl show docker.service -p ExecStart -p FragmentPath -p DropInPaths
Failed to start Docker, exit-code e Start request repeated too quickly são resultados. Procure perto da primeira saída de dockerd: parsing, duplicação, escrita ou rede. Veja logs. Não inicie outro dockerd com serviço ativo: disputa socket/PID/dados.
Caminho comum /etc/docker/daemon.json, salvo ExecStart com --config-file. Confira só arquivo existente:
sudo python3 -m json.tool /etc/docker/daemon.json
sudo dockerd --validate --config-file=/etc/docker/daemon.json
Primeiro sintaxe JSON; depois dockerd valida sem iniciar. configuration OK não comprova disco/rede/argumentos. Veja --validate em dockerd. Não crie arquivo vazio para conferir.
Faça backup antes:
sudo cp -a /etc/docker/daemon.json /etc/docker/daemon.json.backup.$(date +%Y%m%d%H%M%S)
sudo nano /etc/docker/daemon.json
sudo dockerd --validate --config-file=/etc/docker/daemon.json
Procure vírgula final, comentários, nomes errados e opções de outra versão. Preserve data-root, armazenamento e rede; substituir pode selecionar outro diretório e parecer perda dos contêineres.
Em directives are specified both as a flag and in the configuration file: hosts, confira systemctl cat docker.service, -H fd:///-H unix://... e JSON hosts. Duplicados iguais também podem impedir início. Se basta socket local, reverta hosts acrescentado sem necessidade; endpoints intencionais exigem gestão remota coordenada.
Não simplifique ExecStart=/usr/bin/dockerd perdendo containerd, ativação de socket e argumentos da distribuição. Validação JSON pode não detectar conflito com unit: confira ambos/logs. Não abra API pública sem autenticação 2375.
Se logs apontam recursos/rede/armazenamento:
df -h
df -i
free -h
sudo journalctl -k -b --no-pager -n 200
GB livres não descartam inodes esgotados. OOM pode matar daemon. operation not permitted exige conferir virtualização/capacidade do kernel. Corrija causa sem desligar firewall, trocar driver ou formatar. Não apague /var/lib/docker/data-root; docker system prune não é recuperação universal.
Para /run/user/<UID>/docker.sock ou docker info com rootless, confira usuário, não só sudo systemctl status docker. Entre diretamente por SSH:
id -u
systemctl --user status docker.service --no-pager -l
journalctl --user -u docker.service -b --no-pager -n 100
docker context ls
Confirme instalação/intenção:
systemctl --user start docker.service
Se rootless existe, teste:
env -u DOCKER_HOST -u DOCKER_CONTEXT -u DOCKER_TLS_VERIFY -u DOCKER_CERT_PATH docker --context rootless info
Rootless usa ~/.config/docker/daemon.json e dados diferentes. Sua lista não é a do Engine do sistema. Veja uso rootless. Se systemctl --user mostra Failed to connect to bus, troca como sudo su pode não criar sessão correta; use SSH normal do dono. Veja diagnóstico.
Para seguir após logout/boot, avalie serviço/lingering:
systemctl --user enable docker.service
sudo loginctl enable-linger "$(id -un)"
Não muda socket para /var/run/docker.sock: cliente precisa de usuário/endpoint corretos.
Após validar, sudo systemctl daemon-reload se unit/drop-in mudou; só JSON não exige. Limpe limite de falhas depois da correção:
sudo systemctl reset-failed docker.service
sudo systemctl start docker.service
sudo systemctl is-active docker.service
sudo journalctl -u docker.service -b --no-pager -n 50
Se precisa de restart, planeje interrupção. reset-failed limpa estado, não causa.
Volte ao usuário/ambiente original:
docker version
docker info
docker ps -a
Confira Server, endpoint, contêineres/volumes originais e funções. active não basta. Se contêiner ainda reinicia, veja seus logs sem reinstalar Engine.