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

이 오류가 뜻하는 것

Docker 명령 또는 컨테이너 실행 과정에서 Cannot connect to the Docker daemon at unix:///var/run/docker.sock 문구가 표시된 상태입니다.

이 문서는 화면이나 로그의 원문을 식별하고 다음 확인 순서를 제시합니다. 오류 문구만으로 운영 환경의 단일 원인을 확정하지 않습니다.

확인 절차

1. 실행한 Docker 명령과 이미지 이름·태그를 그대로 기록합니다.
2. docker ps -a와 docker logs <container>에서 종료 상태와 첫 오류를 확인합니다.
3. 호스트 포트, 소켓 권한, 파일 경로를 컨테이너 내부 기준으로 다시 확인합니다.

해결 순서

1. 호스트와 컨테이너의 경로·포트·권한을 분리해 확인합니다.
2. 한 번에 하나의 설정만 바꾸고 docker run 또는 Compose 실행 결과를 다시 기록합니다.
3. 실행이 안정된 뒤에만 사용하지 않는 컨테이너나 이미지를 정리합니다.

주의

• 운영 중인 데이터, 권한, 포트, 인증서와 배포 대상을 한 번에 변경하지 않습니다.
• 수정 전 오류 원문, 실행 명령, 로그 시각과 관련 버전을 보관합니다.
• 공식 문서가 설명하지 않는 환경별 원인은 재현 결과와 해당 플랫폼 문서를 추가로 확인합니다.

공식 근거

• Running containers | Docker Docs (새 창에서 열림)

진단과 해결 순서

1. docker context show와 docker info를 실행해 CLI가 어느 daemon을 대상으로 하는지 기록합니다.
2. DOCKER_HOST가 설정되어 있으면 값과 실제 대상이 일치하는지 확인하고, Docker Desktop 또는 호스트 daemon의 실행 상태를 확인합니다.
3. Linux에서는 /var/run/docker.sock의 소유자·그룹·접근 권한을 확인합니다. 권한 변경은 운영 정책과 승인 범위를 먼저 확인합니다.
4. 연결이 회복되면 같은 이미지·태그와 같은 명령을 다시 실행해 이전 오류가 사라졌는지 확인합니다.

daemon을 찾지 못했다는 문구만으로 소켓 권한 변경이나 서비스 재시작을 바로 실행하지 않습니다. 사용 중인 운영체제와 Docker 배포 방식에 맞는 공식 절차를 확인한 뒤 변경합니다.