macOS 업데이트 이후 Docker Desktop이 실행되지 않을 때 해결 방법

김유경·2025년 7월 11일
1

들어가며

최근 macOS를 업데이트한 이후, Docker Desktop이 갑자기 실행되지 않는 현상을 겪었습니다.

처음엔 도커 버전 문제인 줄 알았는데, 공식 이슈를 찾아보니 macOS 업데이트 이후 권한 문제 또는 바이너리 충돌로 인해 발생하는 이슈인 것 같습니다.

그래서 재설치를 시도했지만, 아래처럼 brew reinstall --cask docker 명령 실행 시 이미 존재하는 바이너리 파일들로 인해 충돌 오류가 반복적으로 발생했습니다.


해결 방법

1) 도커 프로세스 종료

실행 중인 Docker가 있다면 강제로 종료해줍니다.

2) Docker 관련 바이너리 파일 삭제

sudo rm -f /usr/local/bin/docker*
sudo rm -f /usr/local/bin/compose-bridge
sudo rm -f /usr/local/bin/kubectl.docker
sudo rm -f /usr/local/bin/hub-tool

3) 설정 및 캐시 폴더 정리 (선택 사항)

🚨 이 명령어를 실행하면 로컬에 저장된 도커 이미지, 컨테이너, 네트워크 설정 등이 모두 삭제될 수 있습니다. 이미지나 볼륨을 삭제하고 싶지 않다면 이 단계는 건너뛰고 먼저 재설치만 시도해보세요!

rm -rf ~/.docker
rm -rf ~/Library/Containers/com.docker.docker
rm -rf ~/Library/Application\ Support/Docker\ Desktop
rm -rf ~/Library/Group\ Containers/group.com.docker

4) Docker 재설치

brew install --cask docker

정상 작동 확인

이렇게 나오면 해결 완료 🎉

앞으로 맥 업데이트는 신중히 ... 😇

0개의 댓글