개발에 AtoZ까지

[개발도구] Docker Desktop 유료 기준에 걸렸다면 — Colima·OrbStack·Rancher 중 무엇으로 옮길까 본문

개발도구

[개발도구] Docker Desktop 유료 기준에 걸렸다면 — Colima·OrbStack·Rancher 중 무엇으로 옮길까

AtoZ 개발자 2026. 9. 16. 21:37
반응형

법무팀에서 라이선스 현황을 조사하는 메일이 돌 때가 있습니다. 목록에 Docker Desktop이 있으면 개발팀에 질문이 오죠. "이거 무료로 쓰는 거 맞죠?" 많은 팀이 "우리 개발팀은 열 명이라 괜찮다"고 답하는데, 계약서 기준으로는 틀린 답입니다.

정작 날짜가 박힌 사건은 라이선스가 아니라 엔진 API 쪽에 있고요. 이 글에서는 그 두 층을 나눠, 지금 움직여야 하는 팀과 안 움직여도 되는 팀을 갈라 보겠습니다.

다섯 런타임을 직접 설치해 실측한 글은 아닙니다. Docker 구독 약관 원문과 각 프로젝트 공식 문서를 대조했고, 아카이브 스냅샷으로 약관 개정 전후를 비교한 내용까지 담았습니다(확인일 2026년 9월 5일).

OS 커버리지에서 후보가 먼저 잘리고, 그다음 라이선스와 Testcontainers 설정 비용이 붙습니다

250명 "그리고" 매출이 아니라, 둘 중 하나입니다

Docker Subscription Service Agreement 3.2절 원문입니다.

"... use in a commercial undertaking with fewer than 250 employees and less than US $10,000,000 (or equivalent local currency) in annual revenue."

무료 조건이 and로 묶여 있습니다. 조건이 AND면 그걸 부정한 유료 트리거는 OR이 되죠. Docker 설치 문서 배너도 이 형태로 적어 뒀습니다. "more than 250 employees or more than $10 million USD in annual revenue."

그래서 직원 60명·연매출 150억 원짜리 스타트업도 유료 대상입니다. 판정 단위도 팀이 아니라 commercial undertaking, 즉 회사 전체고요. 같은 절이 "Government Entities shall not use Docker Desktop ... without a paid subscription"이라고 규정해서 정부·공공기관은 규모와 무관하게 무료 사용이 금지됩니다.

다만 모회사·계열사 합산 여부는 약관에 명문 규정이 없습니다. 지주회사 구조라면 법무 검토로 확정하셔야 합니다. 8절이 Docker의 감사 권한을 규정하고 있어 애매한 채로 두는 것 자체가 리스크죠.

Docker 공식 Windows 설치 문서 상단 배너. 유료 트리거가 or로 적혀 있습니다 (확인일 2026-09-05)

라이선스는 안 급한데 엔진 API가 급합니다

"약관이 또 바뀐 것 아니냐"는 이야기가 도는데, 아닙니다. DSSA는 2026년 8월 26일에 개정됐지만 5월 29일판 아카이브 스냅샷과 대조하면 250명·$10,000,000 수치와 정부기관 배제 조항은 그대로입니다. 표현만 정리됐고, 신설분은 Agentic Platform Services 정의와 유료 Gordon 관련 문구죠.

Docker Hub도 마찬가지입니다. 2025년 2월 21일 공지로 풀 종량과금은 전면 취소됐고 스토리지 과금은 무기한 연기됐습니다. 현행 제한은 6시간당 미인증 100회·Personal 200회, 유료 플랜은 무제한이고요.

라이선스발 마감선은 없습니다. 대신 기술 쪽에 날짜가 있죠.

시점 사건 결과
2025-11-10 Docker Engine 29.0.0 데몬 최소 API를 v1.44로 상향
2026-03-05 Docker Engine 29.3.0 최소 API를 v1.40(Docker 19.03)으로 완화

최신 29.8.0(2026-09-03)에서도 최소값은 v1.40입니다. 문제는 Testcontainers 1.x가 쓰는 Docker Java 클라이언트의 기본 API가 1.32라는 점이죠. 미달이니 엔진만 29.x로 올라가도 client version 1.32 is too old로 터집니다.

그런데 Testcontainers Java 2.0.0은 파괴적 메이저입니다. JUnit 4 지원이 빠졌고, 모든 모듈에 접두사가 강제되며(org.testcontainers:mysql → org.testcontainers:testcontainers-mysql), 컨테이너 클래스도 패키지가 이동했습니다. 최신 2.x는 2.0.5(2026-04-20)고요.

런타임 교체와 Testcontainers 2.0 이관은 한 덩어리로 묶어야 합니다. "무료 대안으로 바꾸면 비용 0"이라는 계산이 틀어지는 지점이죠.

라이선스 시계는 멈춰 있고 엔진 API 시계만 돌아갑니다

Windows 사용자가 한 명이라도 있으면 후보가 셋입니다

비용보다 먼저 봐야 할 축이 OS 커버리지입니다. 여기서 후보가 기계적으로 잘려 나갑니다.

도구 라이선스·가격(월, 연간 결제) macOS Windows Linux
Colima v0.10.3 (2026-06-04) MIT · $0 ✅ ❌ ✅
Rancher Desktop v1.24.0 (2026-07-29) Apache-2.0 · $0 ✅ ✅ ✅
Podman Desktop v1.29.3 (2026-09-01) Apache-2.0 · $0 ✅ ✅ ✅
OrbStack 클로즈드 · Pro $8 ✅ ❌ ❌
Docker Desktop 4.89.0 (2026-08-31) Pro $9 · Team $15 · Business $24 ✅ ✅ ✅

Colima는 README 부제부터 "container runtimes on macOS (and Linux)"이고, OrbStack은 자사 비교표에서 Windows support를 ❌로 표기합니다. Windows가 섞인 팀에 이 둘을 전사 표준으로 정하면 안 됩니다. OS마다 다른 도구를 쓰면 온보딩 문서와 트러블슈팅이 두 벌이 되니까요.

Rancher Desktop은 macOS 13(Ventura) 이상, Windows 11 또는 Windows Server 2025를 요구하고, Windows에서는 WSL을 설치 프로그램 실행 전에 먼저 깔아야 합니다.

OrbStack은 "무료 대안" 목록에 넣으면 안 됩니다

한국어권 글에서 자주 보이는 오답입니다. 공식 라이선스 문서 문장이 이렇거든요.

"If you are using OrbStack professionally as a freelancer, for a commercial or non-profit entity, or for a government entity ... you must purchase a License."

프리랜서·영리기업·비영리단체·정부기관이 전부 유료 대상입니다. 설치 시 30일 Pro 체험이 주어지지만, 만료되면 개인 비상업 전용 Free로 강등되고요. Docker Business($24)보다 싼 유료 선택지일 뿐 무료 대안이 아닙니다.

성능도 표에 넣지 않았습니다. 공식·중립 벤치마크가 없기 때문입니다. 유일한 수치인 OrbStack 자사 벤치마크부터 그 페이지가 스스로 "late August 2023 ... OrbStack (v0.17.0) and Docker Desktop (v4.22.0)" 기준이라고 밝히거든요. 현재 Docker Desktop은 4.89.0이니 3년 전 측정을 근거로 쓸 수는 없습니다.

Testcontainers를 붙이는 데 환경변수가 몇 개 필요한가요

실무에서 체감되는 이전 비용은 여기서 갈립니다.

도구 macOS 설정 Windows 설정
Podman Desktop 0개 (podman-mac-helper 자동 심링크) DOCKER_HOST 직접 지정
OrbStack 0개 (관리자 권한 시 소켓 심링크 자동) 해당 없음
Colima 3개 (colima start --network-address 전제) 해당 없음
Rancher Desktop 3개 WSL2 0개 / 네이티브 1개

Rancher Desktop의 macOS·Linux 설정은 이렇습니다.

export DOCKER_HOST="unix://$HOME/.rd/docker.sock"
export TESTCONTAINERS_DOCKER_SOCKET_OVERRIDE=/var/run/docker.sock
export TESTCONTAINERS_HOST_OVERRIDE=$(rdctl info --field ip-address)

전제도 붙습니다. macOS 기본값인 VZ 가상머신 타입이어야 하고, QEMU에서는 IP 할당에 관리자 권한이 없으면 컨테이너 포트에 접근하지 못합니다. 엔진도 반드시 moby(dockerd)여야 하는데, 공식 문서가 "The containerd runtime does not expose a Docker-compatible API and will not work with Testcontainers"라고 못박기 때문이죠. rdctl set --container-engine.name=moby로 바꾸시면 됩니다.

여기서 통설 하나가 뒤집힙니다. "Windows가 항상 더 까다롭다"는 말이요. Rancher Desktop 기준으로는 반대입니다. WSL2 통합을 켜면 환경변수가 하나도 필요 없고, 네이티브 Win32는 $env:DOCKER_HOST = "npipe:////./pipe/docker_engine" 하나면 끝이죠. 대신 Windows에서는 TESTCONTAINERS_HOST_OVERRIDE를 설정하면 안 됩니다. macOS 문서를 그대로 복사하면 깨지는 지점입니다.

Podman Desktop의 소켓 자동 연결도 macOS 한정입니다. 공식 문서가 "On Windows and Linux, the Third-Party Docker Tool Compatibility setting is not available"이라고 명시하거든요. rootless면 TESTCONTAINERS_RYUK_DISABLED=true도 필요한데, Ryuk를 끄면 컨테이너 정리가 수동 책임으로 넘어옵니다.

Rancher Desktop 공식 Testcontainers 가이드의 macOS 환경변수 3종과 containerd 경고 (확인일 2026-09-05)

Testcontainers 공식 문서가 대안 런타임을 "not actively tested in the main development workflow"로 규정해 둔 점도 기억해 두세요. 로컬 DB를 Compose로 띄울지 Testcontainers로 띄울지 아직 안 정하셨다면 로컬 DB를 뭘로 띄울까 쪽이 먼저입니다.

docker compose CLI가 같이 딸려오는지도 확인하세요

Spring Boot를 쓰신다면 조용한 함정이 하나 더 있습니다. 공식 문서가 "You need to have the docker and docker compose (or docker-compose) CLI applications on your path. The minimum supported Docker Compose version is 2.2.0."을 요구하거든요.

Rancher Desktop 1.24.0은 docker 29.6.2와 docker-compose 5.3.1, docker-buildx 0.35.0을 번들합니다. 반면 Colima는 docker CLI와 플러그인을 번들하지 않아 brew install docker-buildx 후 ~/.docker/cli-plugins에 심링크하는 식으로 직접 채워야 하고, Podman Desktop도 Compose 확장을 따로 설치해야 합니다. 교체 직후 compose 명령이 안 먹으면 대개 이 PATH 문제죠. 확인 순서는 docker-compose 명령이 안 먹는다면에, 이미지 빌드 쪽은 Spring Boot 이미지 만드는 세 가지에 있습니다.

지금 옮길 팀 / 기다려도 되는 팀 / 하면 안 되는 것

지금 결정해야 하는 경우

  • 직원 250명 이상 또는 연매출 $1,000만 이상인 회사에서 무료로 쓰고 있다.
  • 정부·공공기관·공기업·정부 출연기관이다(규모 무관 즉시 조치).
  • macOS 단일 팀 + Testcontainers → Podman Desktop이 이전 비용 최소. 유료를 감수한다면 OrbStack($8)이 Business($24)보다 쌉니다.
  • Windows·macOS 혼재 → Rancher Desktop이 사실상 유일한 무료 단일 표준.
  • Testcontainers 1.x를 쓴다면 런타임 교체와 무관하게 2.0 이관을 계획에 넣으세요.

기다려도 되는 경우

  • 직원 250명 미만 이면서 연매출 $1,000만 미만인 사기업은 무료 사용이 적법합니다.
  • Team·Business 계약 잔여 기간이 남았다면 갱신 시점을 결정 포인트로 잡고 그 전엔 파일럿만.
  • Testcontainers 없이 docker build·docker compose 정도만 쓰면 소켓 이슈가 거의 없습니다.
  • 2.0 이관 여력이 이번 분기에 없다면 교체를 미뤄 두 작업을 묶는 쪽이 총비용이 낮습니다.

하면 안 되는 것

  • Rancher Desktop을 containerd로 둔 채 Testcontainers 돌리기.
  • Windows 사용자가 있는데 Colima나 OrbStack을 전사 표준으로 정하기.
  • OrbStack을 무료 대안으로 소개하거나 업무에 Free 티어로 쓰기.
  • Docker Hub 풀 과금(2025년 2월 취소)이나 성능(중립 벤치마크 없음)을 명분으로 삼기.
  • 파일럿 없이 일괄 전환하기. CI와 로컬 양쪽에서 최소 한 스프린트는 검증하세요.

자주 도는 이야기 중 사실이 아닌 것

"Docker Desktop만 버리면 Docker 종속이 끝난다." 아닙니다. Testcontainers는 2023년 12월 11일 Docker가 제작사 AtomicJar를 인수해 Docker Inc. 소유입니다. 설정을 자동화해 주는 Testcontainers Desktop도 무료지만 계정 로그인이 필요하고요.

"무료면 그만이다." 벤더 지속성은 비용과 다른 축입니다. OrbStack은 단일 벤더의 클로즈드 소스라 포크가 불가능하고, Colima는 소수 메인테이너 OSS입니다. Rancher Desktop(SUSE)과 Podman Desktop(Red Hat 계열)은 조직 백업이 있고요.

옮기기 전 확인 목록

[ ] 직원 250명 이상 또는 연매출 $1,000만 이상인가 → 하나라도 예면 유료
[ ] 정부·공공 부문인가 → 규모 무관 유료
[ ] 모회사·계열사 합산 여부를 법무에 확인했는가
[ ] 팀에 Windows 사용자가 있는가 → 있으면 Colima·OrbStack 탈락
[ ] Testcontainers 가 1.x 인가 (기본 API 1.32 < 엔진 최소 v1.40)
[ ] Rancher Desktop 이면 엔진이 moby, macOS VM 타입이 VZ 인가
[ ] Podman rootless 면 Ryuk 비활성화에 따른 정리 방식을 정했는가
[ ] docker · docker compose CLI 가 PATH 에 있는가 (Compose 2.2.0 이상)
[ ] CI 와 로컬 양쪽에서 한 스프린트 파일럿을 잡았는가

다음에 볼 글

로컬에서 DB를 Compose로 띄울지 Testcontainers로 띄울지는 로컬 DB를 뭘로 띄울까에 정리해 뒀습니다. 이 글의 소켓 설정 비용이 그 선택에 그대로 얹히거든요.

이 글은 약관 원문과 아카이브 스냅샷, 각 프로젝트 공식 문서와 릴리스 노트를 기준으로 정리했습니다(확인일 2026년 9월 5일). 버전과 가격이 빠르게 움직이는 주제라 실제 도입 시점에는 원문을 다시 확인해 주세요. 잘못된 내용이나 보충이 필요한 부분이 있으면 댓글로 알려 주시면 반영하겠습니다.

참고한 자료

  • Docker Subscription Service Agreement (Last updated on August 26, 2026) — 3.2절 무료 조건·정부기관 배제, 8절 감사 권한 (확인일 2026-09-05)
  • Wayback Machine 스냅샷 — DSSA 2026년 5월 29일판 대조 (확인일 2026-09-05)
  • Install Docker Desktop on Windows / on Mac — 유료 트리거 or 배너 (확인일 2026-09-05)
  • Docker Pricing / Docker Hub usage and limits / 「Revisiting Docker Hub Policies」(2025-02-21) (확인일 2026-09-05)
  • Docker Engine 29 release notes — 29.0.0 최소 API v1.44, 29.3.0 v1.40 완화 (확인일 2026-09-05)
  • Using Testcontainers with Rancher Desktop — 환경변수 3종, moby 전제, client version 1.32 is too old (확인일 2026-09-05)
  • Testcontainers for Java 문서 및 testcontainers-java 2.0.0 릴리스 노트 (확인일 2026-09-05)
  • Rancher Desktop v1.24.0 릴리스 노트·Installation, Podman Desktop Docker compatibility (확인일 2026-09-05)
  • Colima FAQ·릴리스 목록, OrbStack Licensing·Pricing·Compare·Benchmarks (확인일 2026-09-05)
  • Spring Boot 4.1.1 Development-time Services — Compose 2.2.0 최소 버전 (확인일 2026-09-05)
반응형
Comments