Docker로 실행한 서비스가 시작되지 않아요
Docker 명령 뒤 서비스가 시작되지 않을 때 daemon 연결, 포트 점유, 컨테이너 이름 충돌을 구분해 다음 Problem 문서를 선택합니다.
빠른 답변
Docker 서비스가 시작되지 않으면 실행 명령과 오류 원문을 먼저 보존한 뒤 Docker daemon 연결 실패인지, 호스트 포트 점유인지, 컨테이너 이름 충돌인지 구분합니다. 원인을 확인하기 전에 알 수 없는 프로세스나 컨테이너를 삭제하지 않습니다.
이 가이드가 맞는 경우
- 애플리케이션 오류 메시지
- 빌드 성공, 배포 실패
상황별 다음 단계
Cannot connect to the Docker daemon at unix:///var/run/docker.sock
오류에 `Cannot connect to the Docker daemon at unix:///var/run/docker.sock`가 표시됩니다.
listen tcp 0.0.0.0:8080: bind: address already in use
오류에 `listen tcp 0.0.0.0:8080: bind: address already in use`가 표시됩니다.
Conflict. The container name "/app" is already in use by container
오류에 `Conflict. The container name "/app" is already in use by container`가 표시됩니다.
호스팅사·개발자에게 전달할 내용
변경 전 기록
- 실행한 Docker 명령, 이미지·태그, context, 오류 원문과 발생 시각을 전달합니다.
- 호스트 포트·컨테이너 이름·daemon 대상과 최근 Compose 변경을 기록합니다.
- 인증 토큰, 환경 변수의 비밀값, 운영 데이터는 전달하지 않습니다.
알아둘 점
이 가이드는 Docker 실행이 중단된 상황에서 오류 원문을 기준으로 다음 확인 문서를 고릅니다. 원인과 삭제·권한 변경 조치는 각 Problem의 범위에서만 확인합니다.
먼저 기록할 것
- 실행한 명령과 이미지·태그를 그대로 기록합니다.
docker context, 호스트 운영체제, Docker Desktop 또는 daemon 실행 방식을 기록합니다.- 오류 원문, 사용한 포트와 컨테이너 이름을 보존합니다.
상황별 다음 단계
- daemon 소켓에 연결하지 못했다면 Cannot connect to the Docker daemon at unix:///var/run/docker.sock을 확인합니다.
- 호스트 포트가 이미 사용 중이면 listen tcp 0.0.0.0:8080: bind: address already in use를 확인합니다.
- 컨테이너 이름이 이미 사용 중이면 Conflict. The container name "/app" is already in use by container를 확인합니다.
세 문구와 다르면 로그의 첫 오류와 실행 명령을 보존한 뒤 Docker 환경별 문서를 추가로 확인합니다. 알 수 없는 컨테이너·프로세스·볼륨을 먼저 삭제하지 않습니다.
참고 자료
Running containers | Docker Docs (새 창에서 열림)
Docker · 공식 자료 · 확인 범위: Docker 컨테이너 실행 시 이미지, 이름, 포트와 파일 시스템 옵션을 확인할 수 있습니다. · 확인일: 2026-07-28