🐌 학습노트/낙서장

macOS에서Docker Colima 사용

mini_world 2025. 6. 16. 00:27
목차 접기

Docker Desktop, orbstack은 기업환경에서 사용할 수 없어서 완전무료인 Colima를 사용하여 Docker 개발환경을 구성한다.

macOS에서는 Docker Engine이 macOS에서 직접 동작하지 않음
• Docker의 핵심인 Docker Engine (dockerd)는 리눅스 커널 기능에 의존함 (예: cgroups, namespaces 등)
• macOS는 리눅스 커널이 아니기 때문에 Docker Engine을 직접 실행할 수 없음
• 그래서 Linux 가상 머신(VM) 위에서 Docker Engine을 실행해야 함. 이때 Colima 사용.

 

패키지설명

docker Docker CLI 도구 (도커 명령어 사용)
colima Docker Engine을 실행할 macOS용 경량 VM

 

설치

brew install docker
brew install docker-compose
brew install docker-buildx
brew install colima

 

실행

# 실행
colima start

# Docker가 Colima를 바라보는지 확인
docker context ls

NAME       DESCRIPTION                               DOCKER ENDPOINT                                       ERROR
colima *   colima                                    unix:///Users/{dir}/.colima/default/docker.sock
default    Current DOCKER_HOST based configuration   unix:///var/run/docker.sock

# 작동 테스트
docker run hello-world

 

동작확인

# Colima 상태 확인
colima status

INFO[0000] colima is running using macOS Virtualization.Framework
INFO[0000] arch: aarch64
INFO[0000] runtime: docker
INFO[0000] mountType: sshfs
INFO[0000] socket: unix:///Users/{dir}/.colima/default/docker.sock

# Colima 목록 확인
colima list

PROFILE    STATUS     ARCH       CPUS    MEMORY    DISK      RUNTIME    ADDRESS
default    Running    aarch64    2       2GiB      100GiB    docker

# Colima 리소스 변경
colima stop
colima start --cpu 4 --memory 8 --disk 60

# Colima VM 접속
colima ssh
728x90