개발 환경 구축 시 컨테이너 기술은 이제 필수입니다. 특히 macOS 사용자라면 Homebrew(이하 Brew)를 사용하여 Docker Desktop을 설치하고 관리하는 것이 가장 효율적인 방법입니다. 이 가이드는 2025년 12월 현재 최신 macOS 버전(Sonoma 포함)과 M1/M2 칩 기반의 Apple Silicon 환경을 기준으로, Brew를 활용한 Docker Desktop 설치 방법과 초기 환경 설정 팁을 상세히 안내합니다.
📚 함께 읽으면 좋은 글
이 방법을 따르면 터미널 명령 한 줄로 설치를 완료할 수 있으며, 기존 인텔 기반 Mac 사용자뿐만 아니라 Apple Silicon 기반 Mac 사용자도 가장 안정적인 환경을 구축할 수 있습니다. 도커 공식 웹사이트에 접속하여 최신 버전의 특징을 확인해보는 것도 좋습니다.
Homebrew를 이용한 Docker Desktop 설치 과정 확인하기
Docker Desktop을 설치하기 전에 시스템에 Homebrew가 설치되어 있는지 확인해야 합니다. Homebrew는 macOS에서 패키지 관리를 위한 필수 도구로, Docker Desktop을 비롯한 다양한 개발 도구들을 쉽게 설치하고 업데이트할 수 있게 해줍니다.
만약 Homebrew가 설치되어 있지 않다면, 터미널을 열고 다음 명령어를 입력하여 설치를 진행합니다. 설치 과정 중 사용자 비밀번호를 요구할 수 있습니다.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"Brew 설치가 완료되었다면, 이제 Docker Desktop을 설치할 차례입니다. Homebrew Cask를 사용하면 GUI 애플리케이션인 Docker Desktop을 명령어 하나로 설치할 수 있습니다.
brew install --cask docker이 명령어를 실행하면 Brew가 공식 경로에서 최신 버전의 Docker Desktop 설치 파일을 다운로드하고, 자동으로 애플리케이션 폴더에 설치해줍니다. 설치 후에는 Applications 폴더에서 Docker Desktop을 찾아 실행하고 초기 설정을 완료하면 됩니다.
설치 후에는 반드시 Docker Desktop 앱을 실행하여 라이선스 동의 및 필수 권한을 부여해야 합니다. 초기 실행 시 안정적인 사용을 위한 필수 설정이 자동으로 이루어집니다.
M1/M2 Apple Silicon 환경에서의 Docker 설정 상세 더보기
Apple Silicon (M1, M2 칩) 기반의 Mac은 이전 인텔(Intel) 기반 Mac과는 아키텍처가 다릅니다. 다행히 Docker Desktop은 Apple Silicon에 최적화된 버전을 제공하고 있어, 사용자가 별도로 복잡한 설정을 할 필요는 없습니다. Brew를 통해 설치하면 자동으로 Apple Silicon에 맞는 버전이 설치됩니다.
Apple Silicon용 Docker의 주요 이점
- 향상된 성능: 가상화 기술인 VirtioFS를 사용하여 파일 시스템 성능이 인텔 기반의 이전 버전에 비해 크게 향상되었습니다.
- ARM64 아키텍처 지원: Apple Silicon 환경에서 네이티브로 ARM64 기반의 컨테이너 이미지를 실행할 수 있습니다.
- Rosetta 2 지원: 필요한 경우 x86(Intel) 기반의 이미지를 실행하기 위해 Rosetta 2 에뮬레이션을 사용할 수 있지만, 성능 저하를 피하기 위해 가급적 ARM64 이미지를 사용하는 것이 권장됩니다.
M1/M2 사용자라면 Docker 설정(Settings)에서 “Use Virtualization framework”가 활성화되어 있는지 확인하여 최적화된 성능으로 컨테이너를 구동하고 있는지 점검하는 것이 좋습니다.
Docker 컨테이너 구동 확인 및 기본 명령어 보기
Docker Desktop 설치 및 초기 설정이 완료되었다면, 터미널에서 다음 명령어를 실행하여 Docker가 제대로 작동하는지 확인합니다. 이 과정은 도커 환경이 정상적으로 준비되었는지 확인하는 기본 절차입니다.
1. Docker 버전 확인
현재 설치된 Docker 버전 정보를 확인하여 설치 성공 여부를 파악할 수 있습니다.
docker --version docker compose version2. 테스트 컨테이너 실행
hello-world 이미지를 사용하여 간단한 테스트 컨테이너를 실행해봅니다. 이 이미지는 Docker 환경 설정이 올바르게 되었는지 확인하는 데 사용됩니다.
docker run hello-world이 명령어를 실행했을 때, 환영 메시지와 함께 컨테이너가 성공적으로 실행되었다는 출력이 나오면 Docker 환경 설정이 완료된 것입니다.
이후에는 docker pull, docker build, docker run 등의 명령어를 사용하여 원하는 개발 환경을 컨테이너화하여 사용할 수 있습니다. 개발 프로젝트에 필요한 환경을 컨테이너 이미지로 관리하면, 운영체제나 장치에 관계없이 동일한 환경을 쉽게 복제하고 공유할 수 있는 큰 장점이 있습니다.
Docker Desktop 메모리 및 CPU 리소스 최적화 신청하기
Docker Desktop은 macOS 내부적으로 가상 머신(VM)을 사용하여 컨테이너를 실행합니다. 따라서 기본 설정된 리소스(메모리, CPU)가 시스템 전체 성능에 영향을 줄 수 있습니다. 특히 노트북 사용자라면 배터리 수명과 발열 관리를 위해 리소스 설정을 최적화하는 것이 중요합니다.
최적화 팁
- 메모리(Memory) 설정: Docker Desktop 설정 (Settings > Resources > Advanced)에서 메모리 할당량을 프로젝트의 필요 최소치로 설정하세요. 기본값은 다소 높게 설정되어 있을 수 있습니다. 예를 들어, 4GB ~ 8GB 정도로 낮추는 것을 고려해볼 수 있습니다.
- CPU 설정: CPU 코어 개수도 필요에 맞게 조정합니다. 평소 사용하지 않을 때는 2-4 코어로 설정하여 시스템 부하를 줄일 수 있습니다.
- 디스크 이미지 크기: 디스크 이미지 크기 역시 필요한 수준으로 설정하여 불필요한 디스크 공간 낭비를 막습니다.
리소스 설정 변경 후에는 Apply & Restart 버튼을 눌러 Docker Desktop을 재시작해야 적용됩니다. 이러한 최적화는 특히 Apple Silicon 환경에서 뛰어난 성능을 유지하면서도 전력 소모를 최소화하는 데 도움을 줍니다.
Homebrew를 이용한 Docker 업데이트 및 삭제 보기
Brew를 사용하여 Docker Desktop을 설치한 경우, 업데이트와 삭제 역시 Brew 명령어로 간단하게 처리할 수 있어 편리합니다.
1. Docker Desktop 업데이트
Docker Desktop의 새로운 버전이 출시되었을 때, 다음 명령어를 통해 쉽게 업데이트할 수 있습니다. Brew가 자동으로 최신 버전을 다운로드하여 기존 앱을 덮어쓰기 합니다.
brew upgrade --cask docker2. Docker Desktop 삭제
Docker Desktop을 시스템에서 완전히 제거하려면 다음 명령어를 사용합니다. 이 명령어는 애플리케이션뿐만 아니라 관련 파일 시스템 링크까지 정리해줍니다.
brew uninstall --cask docker만약 Docker가 만든 이미지나 볼륨까지 완전히 삭제하려면, 앱을 제거하기 전에 Docker Desktop 내에서 Troubleshoot > Reset to factory settings 옵션을 사용하여 데이터를 정리하는 것이 좋습니다.
📌 추가로 참고할 만한 글
FAQ 자주 묻는 질문
H3 Docker Desktop 설치 시 M1/M2 환경에서 인텔(x86) 이미지를 사용해도 되나요 확인하기
네, 사용할 수 있습니다. Docker Desktop은 Apple Silicon 환경에서 Rosetta 2를 활용하여 인텔(x86) 이미지를 실행할 수 있도록 지원합니다. 하지만 에뮬레이션 과정으로 인해 성능 저하가 발생할 수 있으므로, 가능하면 ARM64 아키텍처를 지원하는 이미지를 사용하는 것이 최적의 성능을 보장합니다.
H3 Homebrew Cask와 일반 Brew의 차이점은 무엇인가요 상세 더보기
일반 brew 명령어는 주로 터미널에서 실행되는 라이브러리, 유틸리티, CLI 도구(예: wget, node)를 설치하는 데 사용됩니다. 반면, brew cask 명령어는 GUI 기반의 데스크톱 애플리케이션(예: Docker Desktop, Chrome, VS Code)을 설치하는 데 사용됩니다. Docker Desktop은 그래픽 인터페이스를 가진 앱이므로 --cask 옵션을 사용해야 합니다.
H3 Docker 설치 후 리소스를 최적화하지 않으면 어떤 문제가 생길 수 있나요 보기
Docker Desktop에 할당된 리소스(CPU, 메모리)가 과도하게 설정된 경우, Mac 시스템 전체의 속도가 느려지거나 발열이 심해지고, 노트북의 경우 배터리 소모가 빨라질 수 있습니다. 특히 복잡한 개발 작업을 하지 않을 때도 불필요하게 많은 리소스가 할당되어 있다면, 위에서 안내된 대로 설정에서 리소스를 조정하는 것이 좋습니다.