Mac에서 docker: 'compose' is not a docker command 오류 해결

Fri, 06 Mar 2026 13:21:51 +0000

배경과 문제 정의

맥을 초기화하고 Homebrew cask로 Docker Desktop 설치 후 docker compose가 동작하지 않음 터미널에 docker: ‘compose’ is not a docker command 메시지 출력, buildx도 동일 증상 재설치와 초기화를 반복했지만 변화 없음

환경

macOS Ventura 13.0.1
Apple Silicon M1
Docker 20.10.21 build baeda1f

원인 가설

Docker Desktop에 포함된 CLI plugin 디렉터리가 docker가 검색하는 경로와 연결되지 않음 compose와 buildx는 독립 바이너리가 아니라 CLI plugin으로 배포됨

해결

CLI plugin 디렉터리에 심볼릭 링크 추가

Troubleshooting on HandsLog

Mac에서 docker: 'compose' is not a docker command 오류 해결

배경과 문제 정의

환경

원인 가설

해결