맥에 Docker 설치? M1/Intel 칩셋별 설정 방법 총정리

M1, M2 또는 Intel 맥에 Docker를 설치하려고 공식 사이트에 접속했는데, 어떤 파일을 받아야 할지 몰라 헤매고 설치 후 제대로 실행되지 않아 답답함을 느끼고 계신가요?

이 문제는 맥의 칩셋 아키텍처 차이 때문에 발생하며, 공식 문서만으로는 혼란스러울 때가 많습니다.

이 글에서는 여러분의 맥 칩셋에 맞는 Docker Desktop 설치 파일을 정확히 선택하는 방법부터, 설치 후 필수적인 초기 설정과 흔히 겪는 문제 해결까지, 모든 과정을 3가지 핵심 단계로 명확하게 안내해 드립니다.

맥 칩셋 확인하기: M1/M2(Apple Silicon) vs Intel

Docker Desktop은 맥 칩셋 종류에 따라 다운로드해야 하는 설치 파일이 다릅니다. 잘못된 파일을 설치하면 Docker가 아예 실행되지 않거나, 비정상적으로 동작할 수 있습니다. 따라서 설치를 시작하기 전에 자신의 맥 칩셋을 정확히 확인하는 것이 가장 중요합니다.

칩셋 확인은 단 2분이면 충분하며, 아래의 간단한 단계로 진행할 수 있습니다.

1. ‘이 Mac에 관하여’ 열기 — 화면 왼쪽 상단에 있는 Apple 메뉴()를 클릭한 다음, ‘이 Mac에 관하여’를 선택합니다.
2. 칩셋 정보 확인 — 열린 창에서 ‘칩’ 또는 ‘프로세서’ 항목을 확인합니다.
   • ‘Apple M1’, ‘Apple M2’ 등: Apple Silicon 칩셋입니다.
   • ‘Intel’로 시작하는 이름 (예: Intel Core i7): Intel 칩셋입니다.

Docker Desktop 설치 파일 선택 및 다운로드

이제 여러분의 맥 칩셋을 정확히 알았으니, 이에 맞는 Docker Desktop 설치 파일을 다운로드할 차례입니다. Docker 공식 다운로드 페이지에 접속하면 여러 가지 옵션이 보이는데, 칩셋별로 파일을 구분해야 합니다.

Apple Silicon 칩셋 맥을 사용한다면 ‘Apple chip’ 또는 ‘Apple Silicon’으로 명시된 파일을, Intel 칩셋 맥을 사용한다면 ‘Intel chip’ 또는 ‘Intel’로 명시된 파일을 선택해야 합니다. 일반적으로 파일 크기는 300MB에서 500MB 사이입니다.

Docker 초기 설정 및 최적화 (필수)

Docker Desktop 설치가 완료되었다면, 초기 설정을 통해 사용 환경을 최적화하는 과정이 필수적입니다. 이 과정을 건너뛰면 Docker가 맥의 자원을 과도하게 사용하거나, 매번 수동으로 실행해야 하는 불편함이 생길 수 있습니다.

특히 메모리 및 CPU 할당은 Docker 컨테이너의 성능과 맥 시스템 전반의 안정성에 직접적인 영향을 미치므로 신중하게 설정해야 합니다.

1. 리소스 설정 (CPU/Memory) — Docker Desktop 아이콘 클릭 후 ‘Settings’ (또는 ‘환경설정’) > ‘Resources’ 탭으로 이동합니다.
   • CPU: 맥의 코어 수의 절반 정도를 할당하는 것을 권장합니다. 예를 들어 8코어 맥이라면 4코어를 할당합니다.
   • Memory: Docker Desktop의 기본 메모리 할당은 2GB입니다. 복잡한 컨테이너를 여러 개 실행할 계획이라면 최소 4GB 이상으로 설정하는 것이 좋습니다. 맥 전체 메모리의 25~50% 수준이 적당합니다.
2. 자동 시작 설정 — ‘Settings’ > ‘General’ 탭에서 ‘Start Docker Desktop when you log in’ 옵션을 활성화합니다. 이렇게 하면 맥 부팅 시 Docker Desktop이 자동으로 실행되어 편리합니다.
3. 업데이트 설정 — ‘Settings’ > ‘Software updates’ 탭에서 ‘Automatically check for updates’ 옵션을 적절히 설정합니다. 최신 버전을 유지하는 것이 보안 및 기능 개선에 유리하지만, 안정적인 환경이 중요하다면 수동 업데이트를 고려할 수 있습니다.

Docker 설치 확인 및 문제 해결

설치와 초기 설정을 마쳤다면, Docker가 시스템에 정상적으로 설치되고 실행되는지 확인해야 합니다. 이 과정에서 예상치 못한 문제가 발생할 수도 있으므로, 기본적인 문제 해결 방법도 함께 알아두는 것이 좋습니다.

대부분의 문제는 몇 가지 간단한 단계로 해결할 수 있습니다.

1. Docker Desktop 상태 확인 — 맥 상단 메뉴바의 Docker 아이콘이 녹색으로 표시되어 있는지 확인합니다. 만약 회색이거나 경고 메시지가 있다면, Docker Desktop 애플리케이션을 다시 시작해 보세요.
2. `docker` 명령어 실행 — 터미널(Terminal)을 열고 다음 명령어를 입력하여 Docker가 정상적으로 인식되는지 확인합니다.
   • docker --version: Docker 클라이언트 버전이 출력되어야 합니다.
   • docker run hello-world: ‘Hello from Docker!’ 메시지가 출력되면 Docker 엔진이 정상적으로 작동하는 것입니다.
3. 일반적인 문제 해결 — 위 테스트에서 문제가 발생한다면 다음을 시도해 보세요.
   • Docker Desktop 재시작: 가장 기본적인 해결책입니다. 메뉴바 아이콘 클릭 후 ‘Restart Docker Desktop’을 선택합니다.
   • 맥 재부팅: 시스템 레벨의 문제를 해결하는 데 효과적입니다.
   • Rosetta 2 설치 확인 (M1/M2 맥에서 Intel 컨테이너 사용 시): Apple Silicon 맥에서 Intel 기반 Docker 이미지를 실행해야 한다면, Rosetta 2가 설치되어 있어야 합니다. 터미널에 softwareupdate --install-rosetta를 입력하여 설치할 수 있습니다.
   • Docker Desktop 재설치: 모든 방법이 실패했을 때 고려합니다. 기존 데이터를 백업한 후 완전히 삭제하고 다시 설치합니다.