Docker설정
Docker 포트 할당 충돌 — port is already allocated
Bind for 0.0.0.0:<port> failed: port is already allocated
한 줄 해결: 호스트 포트를 이미 다른 컨테이너/프로세스가 점유해 컨테이너가 뜨지 못한 것으로, 점유 컨테이너를 정리하거나 다른 호스트 포트로 매핑합니다.
이런 증상일 때
docker run/compose up 시 port is already allocated로 컨테이너 기동이 실패합니다. 이전에 띄운 컨테이너가 남아 있는 경우가 흔합니다.
원인
- 같은 호스트 포트를 매핑한 컨테이너가 이미 실행 중(또는 비정상 종료 후 잔류)
- 호스트의 다른 프로세스가 그 포트를 점유
- compose 재실행 시 이전 컨테이너가 정리되지 않음
해결 방법
1
점유 컨테이너 확인·정리
실행 중 컨테이너를 확인하고 중지/제거합니다.
docker ps
docker stop <id> && docker rm <id>2
compose 정리 후 재기동
compose는 down으로 깔끔히 정리한 뒤 up 합니다.
docker compose down && docker compose up -d3
호스트 포트 변경
포트 매핑의 호스트 쪽 번호를 다른 값으로 바꿉니다.
docker run -p 8081:80 myimage # 호스트 8081💡 예방: compose down으로 컨테이너를 정리하고, 개발용 포트는 충돌이 적은 대역으로 통일하세요.
Dockerportallocatedcompose포트충돌