Tutoriales de VPS
Cannot connect to Docker daemon en VPS: servicio y context (2026)
Confirma endpoint, distingue Docker del sistema y rootless y revisa logs/configuración antes de validar contenedores y volúmenes originales.

Si docker ps, docker compose up o un despliegue muestra Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?, no empieces reinstalando. El cliente no conectó con el daemon seleccionado: servicio parado, endpoint erróneo, mezcla rootless/sistema o configuración inválida.
La guía cubre VPS Linux con systemd: destino, servicio/logs, causa y negocio original. Desktop, Kubernetes y runtimes independientes de panel necesitan su gestión específica.
| Error/dirección | Investigar |
|---|---|
Cannot connect ... unix:///var/run/docker.sock | Daemon del sistema y socket |
/run/user/1000/docker.sock | Rootless del usuario y sesión |
tcp://... / ssh://... | Context, entorno y remoto |
permission denied while trying to connect | Permiso/identidad, no necesariamente servicio parado |
docker.service: Failed / Start request repeated too quickly | Primer fallo real del journal |
Unit docker.service could not be found | Solo CLI u otra instalación |
docker --version acredita CLI. docker version distingue Client de Server fallido. Consulta daemon.
Usa mismo usuario y terminal:
docker version
docker context show
docker context ls
docker context inspect
env | grep -E '^DOCKER_(HOST|CONTEXT|TLS_VERIFY|CERT_PATH)='
Entorno vacío suele ser variables sin definir. Revisa endpoint/error. DOCKER_HOST, DOCKER_CONTEXT, --host y --context influyen; la estrella docker context ls no basta. Consulta contexts.
Si el remoto es intencional, revisa host/SSH/TLS sin cambiar a local. Para Engine local del sistema, compara un comando:
env -u DOCKER_HOST -u DOCKER_CONTEXT -u DOCKER_TLS_VERIFY -u DOCKER_CERT_PATH docker --context default info
Limpia variables relevantes y selecciona default solo aquí. Si funciona, corrige fuente en script/shell/CI. Conserva otros ajustes/contexts usados. sudo docker ... y usuario común pueden leer distintas cuentas; éxito con sudo no prueba mismo daemon.
Para Engine del 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 no prueba respuesta. Confirma /var/run/docker.sock y prueba explícitamente:
sudo env -u DOCKER_HOST -u DOCKER_CONTEXT -u DOCKER_TLS_VERIFY -u DOCKER_CERT_PATH docker --host unix:///var/run/docker.sock info
Si funciona pero usuario recibe permission denied en el mismo socket, consulta permisos/grupos. No uses chmod 666 /var/run/docker.sock: ese acceso permite control privilegiado del host.
Con Engine correcto y sin errores de datos/configuración:
sudo systemctl start docker.service
sudo systemctl is-active docker.service
Consulta inicio. Si falla, lee logs sin repetir continuamente.
Comprueba CLI y daemon:
command -v docker
command -v dockerd
systemctl list-unit-files 'docker*' 'containerd*'
docker no instala Engine. Rootless, Snap, binarios o panel pueden tener otra gestión. Usa origen real sin mezclar paquetes. Improvisar docker.service complica sockets, containerd y argumentos.
Consulta logs completos y unit efectivo:
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 y Start request repeated too quickly son consecuencias. Busca cerca de la primera salida de dockerd: parseo, duplicados, escritura o red. Consulta logs. No inicies otro dockerd con servicio activo: compite por socket/PID/datos.
Ruta habitual /etc/docker/daemon.json, salvo ExecStart con --config-file. Revisa solo archivo existente:
sudo python3 -m json.tool /etc/docker/daemon.json
sudo dockerd --validate --config-file=/etc/docker/daemon.json
Primero sintaxis JSON; después dockerd valida sin iniciar. configuration OK no acredita disco/red/argumentos unit. Consulta --validate en dockerd. No crees archivo vacío para comprobar.
Respalda 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
Busca comas finales, comentarios, errores y opciones de otra versión. Conserva data-root, almacenamiento y red; sustituir puede apuntar a otros datos y parecer que desaparecieron contenedores.
Ante directives are specified both as a flag and in the configuration file: hosts, revisa systemctl cat docker.service, -H fd:///-H unix://... y JSON hosts. Duplicados incluso iguales pueden impedir inicio. Si basta socket local, revierte hosts añadido innecesariamente; endpoints intencionales requieren gestión remota coordinada.
No simplifiques ExecStart=/usr/bin/dockerd perdiendo containerd, activación socket o ajustes del paquete. Validar JSON no siempre detecta conflicto con unit: compara ambos y logs. No abras API pública sin autenticación 2375.
Si logs señalan recursos/red/almacenamiento:
df -h
df -i
free -h
sudo journalctl -k -b --no-pager -n 200
GB libres no descartan inodos agotados. OOM puede matar daemon. operation not permitted requiere revisar capacidad de virtualización/kernel. Corrige causa sin desactivar firewall, cambiar drivers o formatear. No borres /var/lib/docker/data-root; docker system prune no es recuperación universal.
Para /run/user/<UID>/docker.sock o docker info con rootless, revisa usuario, no solo sudo systemctl status docker. Entra directamente 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
Confirma instalación/intención:
systemctl --user start docker.service
Si existe rootless, prueba:
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 y datos distintos. Su lista no es la del Engine del sistema. Consulta uso rootless. Si systemctl --user muestra Failed to connect to bus, un cambio como sudo su puede carecer de sesión adecuada; usa SSH normal del propietario. Consulta diagnóstico.
Para continuar tras logout/boot, evalúa servicio/lingering:
systemctl --user enable docker.service
sudo loginctl enable-linger "$(id -un)"
No cambia socket a /var/run/docker.sock: usa usuario/endpoint correctos.
Tras validar, sudo systemctl daemon-reload si cambió unit/drop-in; JSON solo no lo necesita. Limpia rate-limit de fallos después de reparar:
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
Si necesita restart, planifica interrupción. reset-failed limpia estado, no causa.
Vuelve a usuario/entorno original:
docker version
docker info
docker ps -a
Verifica Server, endpoint, contenedores/volúmenes originales y funciones. active no basta. Si un contenedor sigue reiniciando, revisa sus logs, sin reinstalar Engine.