Conflict. The container name "/app" is already in use by container
빠른 답변
- 이 오류는 무엇인가요?
- Conflict. The container name "/app" is already in use by container 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.
- 가장 흔한 원인은 무엇인가요?
- Conflict. The container name "/app" is already in use by container 문구가 표시되면 실행한 Docker 명령, 이미지·컨테이너 상태, 포트·소켓·파일 경로와 로그를 함께 확인해야 합니다. Docker 명령 또는 컨테이너 실행 과정에서 Conflict. The container name "/app" is already in use by container 문구가 표시된 상태입니다.
- 무엇을 먼저 확인해야 하나요?
- 실행한 Docker 명령과 이미지 이름·태그를 그대로 기록합니다.
현재 증상
- 애플리케이션 오류 메시지
먼저 확인할 항목
실행한 Docker 명령과 이미지 이름·태그를 그대로 기록합니다.
`docker ps -a`와 `docker logs <container>`에서 종료 상태와 첫 오류를 확인합니다.
호스트 포트, 소켓 권한, 파일 경로를 컨테이너 내부 기준으로 다시 확인합니다.
피해야 할 조치
주의
- 오류 문구만으로 원인을 단정하지 않고 로그와 실행 환경을 함께 확인합니다.
- 운영 데이터나 권한을 변경하기 전에 백업과 변경 범위를 기록합니다.
환경별 원인과 조치
이 오류가 뜻하는 것
Docker 명령 또는 컨테이너 실행 과정에서 Conflict. The container name "/app" is already in use by container 문구가 표시된 상태입니다.
이 문서는 화면이나 로그의 원문을 식별하고 다음 확인 순서를 제시합니다. 오류 문구만으로 운영 환경의 단일 원인을 확정하지 않습니다.
확인 절차
- 실행한 Docker 명령과 이미지 이름·태그를 그대로 기록합니다.
docker ps -a와docker logs <container>에서 종료 상태와 첫 오류를 확인합니다.- 호스트 포트, 소켓 권한, 파일 경로를 컨테이너 내부 기준으로 다시 확인합니다.
해결 순서
- 호스트와 컨테이너의 경로·포트·권한을 분리해 확인합니다.
- 한 번에 하나의 설정만 바꾸고
docker run또는 Compose 실행 결과를 다시 기록합니다. - 실행이 안정된 뒤에만 사용하지 않는 컨테이너나 이미지를 정리합니다.
주의
- 운영 중인 데이터, 권한, 포트, 인증서와 배포 대상을 한 번에 변경하지 않습니다.
- 수정 전 오류 원문, 실행 명령, 로그 시각과 관련 버전을 보관합니다.
- 공식 문서가 설명하지 않는 환경별 원인은 재현 결과와 해당 플랫폼 문서를 추가로 확인합니다.
공식 근거
진단과 해결 순서
- 오류에 표시된 컨테이너 이름과 실행 명령을 기록합니다.
docker ps -a --filter name=app처럼 실제 이름으로 검색해 컨테이너 ID, 상태와 생성 시각을 확인합니다.- 기존 컨테이너가 재사용 대상인지 판단합니다. 제거해야 한다면 데이터 볼륨과 운영 트래픽 영향을 확인하고 중지된 대상만 승인된 절차로 정리합니다.
- 새 이름으로 실행했다면 Compose 파일, 모니터링 대상과 운영 문서가 새 이름을 가리키는지 확인합니다.
참고 자료
Running containers | Docker Docs (새 창에서 열림)
Docker · 공식 자료 · 확인 범위: Docker 공식 문서는 컨테이너 실행 명령, 이미지, 포트와 파일 시스템 옵션을 설명합니다., 이 오류 원문은 해당 실행 설정과 컨테이너 로그를 비교해 확인해야 합니다. · 확인일: 2026-07-28