1. 개요

도커 컨테이너를 종료할 때는 docker-compose down과 docker compose stop을 사용합니다.

이 둘은 모두 컨테이너를 종료하는 데 사용되지만 명령에 따른 효과는 차이를 보입니다.

본 글에서는 이 두 명령어의 차이점에 대해 서술합니다.

2. docker-compose stop

• 현재 docker-compose up 으로 실행 중인 **컨테이너를 “중지(stop)”**합니다.
• 컨테이너는 삭제되지 않으며, 상태는 “중지됨(stopped)” 상태로 남아 있습니다.

2.1. 실행 효과

• 컨테이너 상태 : 중지 (삭제되지 않음)
• 네트워크 : 그대로 유지됨
• 볼륨 : 그대로 유지됨
• 다시 시작 가능 : docker-compose start 로 빠르게 재시작 가능
• 캐시 / 설정 유지 : ✅ 그대로 유지됨

2.2. 실행 예시:

docker-compose stop

3. docker-compose down

• Compose 환경 전체를 정리하고 종료
• 모든 관련 리소스 (컨테이너, 네트워크, 기본 볼륨 등)를 삭제

3.1 실행 효과

• 컨테이너 상태: 완전 삭제
• 네트워크 : 삭제됨 (사용 중인 전용 네트워크 포함)
• 볼륨 : 기본은 유지됨, -v 옵션 시 삭제
• 이미지 : 기본은 유지됨, --rmi 옵션 시 삭제 가능
• 다시 시작 가능 여부 : up으로 재생성 필요

3.2. 실행 예시:

docker-compose down

4. 요약

• stop은 일시정지 (컨테이너는 남아 있음)
• down은 완전종료 + 컨테이너/네트워크/옵션에 따라 볼륨 삭제