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

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

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

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

Docker Desktop이 왜 필요한가요?

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

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

컨테이너를 쓴다는 건 로봇 코드가 도는 자리가 항상 리눅스라는 뜻이기도 합니다. 윈도우에서 쓰시더라도 실제 빌드는 컨테이너 안에서 이뤄집니다.

뒤집어 보면 좋은 점도 있습니다. 학생 PC마다 ROS 2 버전이 달라서 생기는 문제가 없어집니다. 저희가 받은 이미지의 컨테이너 태그는 humble이었고, 어느 PC에서 열든 같은 ROS 2 Humble 환경이 뜹니다.

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

세 줄이 조금씩 달라 보이지만 원인은 하나입니다. activate, pipeline, post-open 순서로 같은 실패가 단계마다 다시 보고되는 것뿐이에요. 그래서 같은 줄이 계속 반복됩니다. 처음 보면 뭐가 문제인지 감이 안 잡혀요.

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

Docker를 켠 뒤 바로 실행해도 되나요?

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

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

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

터미널 쪽이 편하시면 docker info 한 줄로도 확인됩니다. 데몬이 아직이면 오류가 나고, 떴으면 설정 정보가 쭉 나옵니다.

실습 수업이라면 이 항목 하나만 미리 공지해도 첫 시간이 훨씬 수월합니다. 학생들이 각자 막혀서 손을 드는 지점이 대부분 여기입니다.

시작 전에 무엇을 확인해야 하나요?

• OS — Windows 10 / 11. macOS와 Ubuntu도 지원합니다
• Docker Desktop — 필수입니다. 그리고 실행 중이어야 합니다
• 디스크 여유 — 15GB 이상
• RAM — 16GB가 최소, 32GB 권장
• 인터넷 — 첫 실행 때 약 12GB를 내려받습니다

RAM을 32GB로 권하는 데는 이유가 있습니다. 윈도우에서 Docker Desktop은 WSL2 위에서 도는데, 저희 PC에서 WSL2가 혼자 3~5GB를 잡고 있었습니다. 16GB짜리 PC라면 시뮬레이터가 쓸 몫이 그만큼 줄어듭니다.

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

컨테이너는 언제 받아오나요?

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

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

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

• 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를 설치하고 Docker가 꺼져 있을 때의 오류 문구, Docker를 켠 뒤 데몬이 응답하기까지의 시간을 직접 확인했습니다.
• 확인하지 못한 것 — Docker Desktop 외의 런타임은 검증하지 않았고, 데몬이 응답하기까지 걸린 25.7초는 저희 PC 기준입니다.

다음 단계

이 글 다음에 이어서 읽으면 좋은 글입니다.

• 설치 화면엔 1.55GB라는데 실제로는 13.4GB 듭니다 — Docker 이미지까지 합친 실제 디스크 용량과 설치·첫 실행 시간을 재 보았습니다.
• Booster Studio를 관리자 권한으로 켜지 마세요 — 설치 단계 중 눈여겨볼 곳과 실행 권한을 다룹니다.
• Booster Studio에서 첫 프로젝트는 어떻게 만드나요? — Docker를 켜 두었다면 프로젝트를 만드는 순서로 이어집니다.

---

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