Booster Studio 설치 전에 Docker를 먼저 설치하세요

Booster Studio 설치하시려는 분께 딱 하나만 먼저 말씀드릴게요.

Docker Desktop을 먼저 설치하세요. 그리고 켜두세요.

이게 공식 다운로드 페이지에 안 적혀 있습니다. 저희도 설치 다 하고 프로젝트까지 만든 다음에 막혔거든요.

왜 필요하냐면요

Booster Studio는 로봇 코드를 ROS 2 컨테이너 안에서 빌드합니다. 시뮬레이터도 컨테이너로 띄우고요.

그러니까 Docker가 없으면 아무것도 안 돌아갑니다. 에디터는 켜지는데 프로젝트를 만드는 순간 멈춥니다.

안 켜져 있으면 이 에러가 나옵니다

[error] [activate] Failed to pull image: Docker daemon connection error
[error] [pipeline] failed: Failed to pull image: Docker daemon connection error
[error] [post-open] pipeline failed: Docker daemon connection error

같은 줄이 계속 반복됩니다. 처음 보면 뭐가 문제인지 감이 안 잡혀요.

화면 우측 상단 상태 표시줄에 Docker not running이라고 조그맣게 떠 있는데, 저희는 이걸 한참 뒤에야 봤습니다.

켜고 나서 30초는 기다리세요

여기서 한 번 더 당하실 수 있습니다.

Docker Desktop을 켜도 바로 되는 게 아닙니다. 저희 PC에서는 데몬이 실제로 응답하기까지 25.7초가 걸렸어요.

작업 표시줄의 고래 아이콘이 초록색 Running으로 바뀔 때까지 기다리시면 됩니다. 켜자마자 안 된다고 당황하지 마세요.

시작 전 체크리스트

| 항목 | 필요한 것 | |---|---| | OS | Windows 10 / 11 (macOS·Ubuntu도 지원) | | Docker Desktop | 필수 · 실행 중이어야 함 | | 디스크 여유 | 15GB 이상 | | RAM | 16GB 최소 / 32GB 권장 | | 인터넷 | 첫 실행 때 약 12GB 내려받음 |

디스크는 넉넉히 잡으세요. 설치 화면에 뜨는 안내보다 실제로 훨씬 많이 듭니다. 그 얘기는 따로 정리해 뒀습니다.

컨테이너를 언제 받아오냐면

설치할 때가 아니라 프로젝트를 처음 실행할 때입니다.

그래서 설치는 멀쩡히 끝납니다. 에디터도 켜지고요. 막히는 건 그다음이에요. 저희가 뒤늦게 당한 이유가 이겁니다.

첫 실행에 받아오는 이미지가 두 개입니다.

• agent-dev — 2.35 GB, 약 105초
• virtual-robot — 9.52 GB, 약 5분

합쳐서 약 12GB, 7분 정도 걸렸습니다. 해외 레지스트리에서 받는 거라 걱정했는데 평균 11.4 MB/s 나왔어요.

두 번째 실행부터는 캐시가 남아 1분 안에 뜹니다. 처음 한 번만 각오하시면 됩니다.

자주 받는 질문

---

여기 내용은 저희가 Windows 11에 Booster Studio 1.11.4를 직접 설치하며 확인한 것입니다.