Colima 완전 가이드 — 가볍고 빠른 CLI 중심 도구, 프로파일 200% 활용법

작성자:


지난 편에서 Docker Desktop을 다뤘다면, 이번 편의 주인공은 그 정반대 철학을 가진 도구입니다. GUI를 버리고, 군더더기를 버리고, CLI 하나로 승부하는 도구 — Colima입니다.

이름부터 정직합니다. Containers on Lima. Lima(macOS·Linux용 경량 VM 도구) 위에서 컨테이너를 돌리는 것, 그게 전부입니다. 그 단순함이 강점이고, 동시에 Docker Desktop의 라이선스 부담에서 벗어나려는 개발자들에게 가장 합리적인 무료 대안 중 하나로 자리잡은 이유입니다.

이 가이드도 macOS(Apple Silicon)를 기준으로 작성되었습니다.

1. Colima 소개

Colima는 Abiola Ibrahim이 만든 오픈소스 프로젝트로, 2021년경부터 본격적으로 알려졌습니다. Docker Desktop이 유료화 정책을 도입한 시점과 맞물리며 빠르게 사용자를 확보했습니다.

기술적으로는 다음 구조입니다.

[ docker CLI / nerdctl ]
         ↓
[ Colima ] ── 관리 인터페이스
         ↓
[ Lima ] ── macOS용 경량 Linux VM
         ↓
[ Docker Engine 또는 containerd ]

Colima 자체는 컨테이너 런타임이 아닙니다. Lima로 리눅스 VM을 띄우고, 그 안에 Docker Engine 또는 containerd를 자동으로 구성해주는 얇은 관리 도구입니다. 그래서 무겁지 않고, 사용자가 보는 인터페이스는 표준 docker CLI 그대로입니다.

탄생 배경

Docker Desktop의 라이선스 정책 변경은 많은 개발자들에게 “표준이 무료가 아니게 된” 충격이었습니다. 이 시기에 등장한 무료 대안이 여럿 있었지만, “Docker CLI를 그대로 쓰면서, 가장 얇은 도구로” 라는 요구를 정확히 만족시킨 것이 Colima였습니다.

2. 특징과 강점/약점

강점

  • 완전 무료 오픈소스 (MIT 라이선스), 상업적 사용 제한 없음
  • Docker CLI와 100% 호환 — docker 명령어를 그대로 쓸 수 있음
  • 매우 가벼움 — Docker Desktop 대비 메모리·CPU 사용량이 눈에 띄게 적음
  • 프로파일 기능 — 여러 독립된 컨테이너 환경을 동시에 운영 가능
  • 런타임 선택 — Docker Engine과 containerd 중 선택 가능
  • Kubernetes 옵션 제공 — --kubernetes 플래그 하나로 K3s 활성화

약점

  • GUI 없음 — 터미널 사용에 익숙해야 함 (단, 별도 GUI 도구 Lima/Colima 호환 가능)
  • Windows 미지원 — macOS와 Linux만 지원
  • 자료가 상대적으로 적음 — Docker Desktop만큼 한국어·영문 자료가 풍부하진 않음
  • 첫 시작 시간 — VM을 띄우는 구조이므로 colima start 첫 실행은 30초~1분 소요

3. 설치 방법 (macOS, Apple Silicon)

Homebrew로 한 줄이면 끝납니다.

brew install colima docker docker-compose
  • colima: Colima 자체
  • docker: Docker CLI (Colima는 CLI를 별도로 깔아줘야 함)
  • docker-compose: Compose 플러그인

시작

colima start

처음 실행하면 VM 이미지를 다운로드하고 부팅합니다. 30초~1분 정도 걸립니다. 완료되면 docker ps 같은 명령이 바로 동작합니다.

설치 확인

colima status
docker --version
docker run hello-world

hello-world 컨테이너가 정상적으로 출력되면 모든 게 잘 동작하는 것입니다.

시작 시 자원 지정

기본값은 CPU 2개, 메모리 2GB, 디스크 60GB입니다. 더 늘리고 싶다면:

colima start --cpu 4 --memory 8 --disk 100

이 설정은 처음 시작할 때만 적용되며, 이후엔 colima stop으로 끄고 다시 시작할 때 자원만 바꿔서 시작할 수 있습니다.

4. 기본 사용법

Colima 자체의 명령은 단순합니다. 컨테이너 명령은 표준 docker CLI 그대로이므로 이전 편(Docker Desktop)의 사용법을 그대로 적용할 수 있습니다.

Colima 자체 명령

# 시작 / 중지 / 재시작
colima start
colima stop
colima restart

# 상태 확인
colima status

# 완전 삭제 (VM과 데이터까지)
colima delete

# 버전 확인
colima version

# VM 안으로 SSH 접속 (디버깅용)
colima ssh

컨테이너 명령은 docker 그대로

Colima가 일단 켜져 있으면 그 다음은 평범한 도커 사용법입니다.

docker run -d -p 8080:80 --name web nginx
docker ps
docker logs web
docker exec -it web /bin/bash

docker compose up -d
docker compose down

이전 편의 모든 명령어가 그대로 동작합니다.

Kubernetes도 한 옵션

colima start --kubernetes

이렇게 띄우면 내부적으로 K3s가 함께 올라옵니다. kubectl 명령으로 바로 클러스터를 다룰 수 있습니다 (kubectl은 별도 설치: brew install kubectl).

5. 프로파일 — Colima의 진짜 강점

Colima의 가장 강력한 기능이자 다른 도구와 차별화되는 지점이 프로파일(Profile) 입니다. 한 머신에서 여러 개의 독립된 컨테이너 환경을 동시에 운영할 수 있게 해줍니다.

프로파일 만들기

# 업무용 환경 (자원 넉넉히)
colima start --profile work --cpu 4 --memory 8 --disk 100

# 개인 사이드 프로젝트용 (가볍게)
colima start --profile personal --cpu 2 --memory 4 --disk 60

# Kubernetes 학습용
colima start --profile k8s --kubernetes --cpu 4 --memory 8

각 프로파일은 독립된 VM, 독립된 Docker 소켓, 독립된 이미지·볼륨 저장소를 가집니다. 한 프로파일의 컨테이너가 다른 프로파일에 영향을 주지 않습니다.

프로파일 전환

docker 명령은 항상 “현재 활성화된 프로파일”을 향합니다. 프로파일을 바꾸려면:

# 프로파일 목록 확인
colima list

# work 프로파일로 전환 (start하면 활성화됨)
colima start --profile work

# 특정 프로파일 명시 명령
colima status --profile personal
colima stop --profile work

또는 환경변수로 docker 컨텍스트를 지정할 수도 있습니다.

# work 프로파일의 도커 소켓 사용
export DOCKER_HOST="unix://${HOME}/.colima/work/docker.sock"
docker ps

프로파일 활용 시나리오

  • 업무용 / 개인용 분리: 회사 프로젝트의 컨테이너와 사이드 프로젝트의 컨테이너가 섞이지 않도록
  • 버전이 다른 환경: 한쪽은 Docker, 다른 쪽은 containerd; 한쪽은 K8s 활성화, 다른 쪽은 비활성화
  • 자원 분리: 무거운 빌드용 프로파일과 가벼운 개발용 프로파일을 따로

이 기능은 개인 머신에서 여러 환경을 깔끔하게 분리하고 싶을 때 가장 빛납니다. (4편에서 다룬 “환경 분리”의 대표 사례입니다.)

6. 실전 팁

시작 옵션 영구 저장

매번 --cpu 4 --memory 8 같은 옵션을 입력하기 귀찮다면, 한 번 지정한 옵션이 다음 시작에도 유지됩니다.

# 첫 시작 시
colima start --cpu 4 --memory 8

# 이후엔 그냥 시작해도 같은 자원으로 뜸
colima stop
colima start

자원 변경이 필요하면 다시 옵션과 함께 start를 실행하면 됩니다.

Apple Silicon에서 amd64 빌드

Docker Desktop과 동일한 방식이 통합니다.

docker run --platform linux/amd64 some-image
docker buildx build --platform linux/amd64,linux/arm64 -t myapp .

다만 Colima는 기본적으로 buildx 인스턴스가 자동 구성되지 않을 수 있으니, 안 되면 다음을 한 번 실행:

docker buildx create --use

Docker Desktop과 공존

이미 Docker Desktop이 깔린 상태에서 Colima를 함께 쓸 수 있습니다. 단, 두 도구가 동시에 켜져 있으면 docker CLI가 어느 쪽을 가리키는지 헷갈릴 수 있습니다. Docker Desktop을 끄고 Colima를 쓰거나, docker context 명령으로 명시적으로 컨텍스트를 바꿔가며 사용하는 것을 권장합니다.

docker context ls
docker context use colima

VM 안 들여다보기

문제가 생겼을 때 VM 내부를 직접 보면 디버깅이 쉽습니다.

colima ssh
# VM 안 셸에서 docker 명령, 시스템 로그 등 직접 확인 가능

자주 쓰는 alias

alias cs='colima status'
alias cl='colima list'
alias cstart='colima start'
alias cstop='colima stop'

7. 다른 OS에서는?

  • Linux: macOS와 동일하게 동작합니다. brew install colima 또는 깃허브 릴리스에서 바이너리를 받아 설치합니다. 단 리눅스에서는 Docker Engine을 직접 설치하는 편이 더 가볍기 때문에, Colima의 매력은 macOS에서 더 큽니다.
  • Windows: 공식 미지원입니다. Windows 사용자는 Rancher Desktop이나 Docker Desktop, Podman Desktop을 검토해야 합니다.

8. 어떤 사용자에게 적합한가

Colima를 추천하는 경우:

  • 터미널이 익숙한 개발자 — GUI 없이도 불편함이 없는 사용자에게 최고의 선택입니다.
  • Docker Desktop 라이선스를 피하고 싶은 사용자 — 동일한 docker CLI를 그대로 쓸 수 있습니다.
  • 메모리·배터리가 아쉬운 macOS 사용자 — Docker Desktop보다 자원 사용량이 명확히 적습니다.
  • 여러 환경을 깔끔하게 분리하고 싶은 사용자 — 프로파일 기능은 다른 도구가 따라오기 어렵습니다.
  • CI 환경과 비슷한 가벼운 개발 환경을 원하는 사용자

다른 도구를 고려해야 하는 경우:

  • GUI가 꼭 필요하다 → Docker Desktop, Rancher Desktop, OrbStack
  • Windows를 쓴다 → Colima는 미지원, 다른 도구 검토
  • Apple Silicon에서 가능한 가장 빠른 환경을 원한다 → OrbStack
  • 여러 사용자가 한 머신을 공유하는 진짜 멀티 유저 환경 → Podman

정리

  • Colima는 Lima 위에 컨테이너를 올린 얇은 관리 도구다
  • 설치는 brew install colima docker docker-compose 한 줄, 시작은 colima start
  • Docker CLI와 완전히 호환되어 기존 워크플로를 그대로 유지할 수 있다
  • 프로파일 기능으로 한 머신에서 여러 독립 환경을 운영할 수 있다 — Colima의 가장 큰 차별점
  • macOS에서 가볍고 무료인 Docker 대안이 필요하다면 가장 합리적인 선택지 중 하나

다음 편에서는 또 다른 무료 대안 — Rancher Desktop을 다룹니다. Colima가 “CLI 미니멀리즘”이라면, Rancher Desktop은 “GUI + Kubernetes 친화”의 길을 갑니다.



댓글 남기기