맥북에 Docker 설치했는데 실행 안 될 때? Apple Silicon 해결 가이드

M1, M2, M3 맥북에 Docker를 힘들게 설치했는데 막상 앱을 실행하려니 로딩 화면만 계속되거나, 아예 열리지 않아 당황하셨나요? 혹은 어렵게 실행했더라도 ‘Optimal Settings’가 뭔지 몰라 답답함을 느끼셨을 겁니다.

이러한 문제는 Apple Silicon 칩셋의 고유한 아키텍처와 Docker Desktop이 요구하는 특정 설정 최적화가 제대로 이루어지지 않았을 때 주로 발생합니다.

이 글에서는 Apple Silicon 맥북에서 Docker Desktop을 안정적으로 설치하고, 초기 실행 문제를 해결하며, 개발 환경에 최적화된 설정을 완료하는 모든 과정을 완벽하게 안내해 드립니다.

Docker Desktop 설치: Apple Silicon에 맞는 버전 선택이 중요

Apple Silicon 맥북 사용자들이 Docker 설치 시 가장 먼저 접하는 문제는 바로 ‘올바른 설치 파일 선택’입니다. 과거 Intel 기반 맥북용 Docker Desktop과 Apple Silicon용 버전이 다르기 때문에, 잘못된 파일을 설치하면 앱이 제대로 실행되지 않거나 예상치 못한 오류를 겪게 됩니다. 최신 버전의 Docker Desktop은 대부분 Apple Silicon을 지원하지만, 다운로드 페이지에서 정확한 아키텍처를 확인하는 것이 필수적입니다.

설치 과정은 간단하지만, 첫 단추를 제대로 끼우는 것이 무엇보다 중요합니다. Docker 공식 웹사이트에서 다운로드 페이지로 이동하여 ‘Mac with Apple chip’ 옵션을 선택해야 합니다. 이렇게 올바른 설치 파일을 선택하면, 향후 발생할 수 있는 대부분의 호환성 문제를 사전에 방지할 수 있습니다.

1. Docker Desktop 다운로드 페이지 접속 — Docker 공식 웹사이트 (docs.docker.com)의 다운로드 섹션으로 이동합니다.
2. Apple Silicon 버전 선택 — ‘Mac with Apple chip’ (Apple Silicon) 옵션을 명확히 확인하고 다운로드 버튼을 클릭합니다. ‘Mac with Intel chip’ 버전을 다운로드하면 실행되지 않습니다.
3. 설치 파일 실행 및 드래그 — 다운로드된 DMG 파일을 열고, Docker 아이콘을 Applications 폴더로 드래그하여 설치를 완료합니다. 이 과정은 약 3분 내외로 진행됩니다.
4. 초기 실행 및 권한 부여 — Applications 폴더에서 Docker를 실행하고, 필요한 경우 관리자 암호를 입력하여 권한을 부여합니다. 약관 동의 및 초기 설정을 진행합니다.

Photo by Foysal Ahmed on Pexels

맥북에서 Docker Desktop 초기 실행 오류 해결 및 기본 설정

Docker Desktop을 설치한 후, ‘Starting…’ 메시지만 보이고 더 이상 진행되지 않거나 앱이 갑자기 종료되는 경험을 하셨을 수 있습니다. 이는 주로 시스템 권한, 가상화 설정 또는 기존 구성과의 충돌 때문에 발생합니다. Apple Silicon 맥북의 경우, Hypervisor.framework를 활용한 가상화 기술을 사용하기 때문에 별도의 설정이 필요 없어 보이지만, 가끔 시스템 재부팅이나 Docker Desktop 재설치가 유일한 해결책이 되기도 합니다.

초기 실행 문제를 해결하고 나면, Docker Desktop의 기본 설정을 최적화하는 것이 중요합니다. 특히, 리소스 할당은 맥북의 전반적인 성능과 Docker 컨테이너의 안정성에 직접적인 영향을 미칩니다. 일반적으로는 기본 설정을 사용해도 무방하지만, 더 높은 성능을 요구하는 작업을 할 경우 RAM과 CPU 코어를 조절하는 것이 좋습니다.

초기 설정 시 몇 가지 중요한 항목들을 점검해야 합니다. Docker Desktop 환경 설정(Settings)으로 들어가 General, Resources 등의 탭을 확인합니다. 특히 ‘Use the new Virtualization framework’ 옵션이 활성화되어 있는지 확인해야 Apple Silicon의 성능을 100% 활용할 수 있습니다. 또한, ‘Start Docker Desktop when you log in’ 옵션을 활성화하여 편리하게 Docker를 사용할 수 있도록 설정하는 것이 좋습니다.

Photo by Kenneth Surillo on Pexels

성능 최적화: Docker 리소스 할당과 고급 설정

Docker 컨테이너가 원활하게 작동하려면 맥북의 리소스를 효율적으로 사용하는 것이 핵심입니다. 기본 설정으로도 대부분의 간단한 컨테이너는 돌아가지만, 여러 개의 컨테이너를 동시에 실행하거나 메모리 집약적인 애플리케이션을 사용할 때는 Docker Desktop에 할당된 RAM과 CPU 코어를 조절하여 성능을 획기적으로 개선할 수 있습니다. 이 과정을 통해 쾌적한 개발 환경을 구축하고, 맥북의 팬 소음이나 발열 문제도 줄일 수 있습니다.

Docker Desktop의 ‘Settings’에서 ‘Resources’ 탭으로 이동하면 CPU, Memory, Swap, Disk Image Size 등을 설정할 수 있습니다. 일반적으로 CPU 코어는 맥북의 절반 정도 (예: 8코어 맥북이라면 4코어), RAM은 총 시스템 메모리의 절반 또는 그 이하 (예: 16GB RAM이라면 4GB~8GB)로 설정하는 것을 권장합니다. 너무 많은 리소스를 할당하면 맥북 전체가 느려질 수 있고, 너무 적게 할당하면 컨테이너 성능이 저하됩니다.

Photo by Derek Xing on Pexels

자주 묻는 질문과 유용한 팁

Docker를 사용하다 보면 예상치 못한 문제에 부딪히거나, 특정 기능을 더 효율적으로 활용하고 싶을 때가 많습니다. 특히 Apple Silicon 환경에서는 과거 Intel 기반에서 사용하던 팁들이 적용되지 않는 경우도 있어, 새로운 접근 방식이 필요할 때가 있습니다. 몇 가지 자주 묻는 질문과 함께 생산성을 높여줄 유용한 팁들을 소개합니다.

“Docker Desktop이 너무 많은 메모리를 사용해요!” 라는 질문은 매우 흔합니다. 이는 Docker 컨테이너 자체의 메모리 사용량과 Docker Desktop 애플리케이션이 사용하는 리소스가 합쳐져서 발생하는 현상입니다. 위에 설명된 리소스 최적화 단계를 통해 할당된 메모리를 조절하고, 사용하지 않는 컨테이너나 이미지를 주기적으로 정리하는 습관을 들이면 약 20% 이상의 리소스 절감 효과를 볼 수 있습니다. `docker system prune -a` 명령어를 사용하면 중지된 컨테이너, 사용되지 않는 이미지, 볼륨, 네트워크를 한 번에 정리할 수 있습니다.

또 다른 팁으로는, Docker Desktop이 맥북 로그인 시 자동으로 실행되도록 설정하는 것입니다. ‘Settings’ -> ‘General’ 탭에서 ‘Start Docker Desktop when you log in’ 옵션을 활성화하면 매번 수동으로 실행하는 번거로움을 줄일 수 있습니다. 또한, Docker Extension 기능을 활용하면 컨테이너 관리, Kubernetes 통합 등 다양한 기능을 Docker Desktop 내에서 바로 사용할 수 있어 개발 효율을 더욱 높여줍니다.