Docker 준비 · 영상 렌더가 멈췄어요
렌더 환경 점검과 첫 빌드 오류를 해결합니다.
Windows·Linux의 최종 영상 합성은 로컬 Docker Linux 엔진을 사용합니다. Mac 기본 렌더에는 FFmpeg·FFprobe와 Xcode Command Line Tools가 필요합니다.
Docker를 사용하는 경우
- Docker를 실행하고 아래 명령을 확인하세요.
- 운영체제 결과가
linux인지 확인하세요. 원격 Docker와 Windows 컨테이너 모드는 지원하지 않습니다. - 설치 마지막에 출력된
setup-renderer명령을 터미널에서 실행하세요. - 완료 후 Codex에서
runtime_check를 요청하고ready=true인지 확인하세요.
터미널에서 실행
docker version
docker info --format "{{.OSType}}"
docker buildx version첫 빌드가 오래 걸리거나 시간 초과돼요
최초 준비는 수 분 걸립니다. AI 앱에서 시간 초과되면 설치가 출력한 명령을 터미널에서 실행하세요. 최소 2 CPU·4GB 메모리와 이미지·소재 저장 공간이 필요합니다. Buildx가 없으면 Docker Desktop을 업데이트하거나 Linux의 docker-buildx-plugin을 설치하세요.
자료 폴더를 읽지 못해요
Docker의 폴더 공유를 확인하세요. Colima에서는 macOS 시스템 임시 폴더 대신 사용자 폴더의 전용 하위 폴더를 사용합니다. 설치·자료 경로에 쉼표가 있다면 쉼표 없는 경로를 사용하세요. WSL은 Docker Desktop에서 해당 배포판의 연결을 켜야 합니다.
새 MCP 버전이나 변경된 소스로 업데이트한 뒤에는 렌더 준비를 다시 실행하세요. ready=false이면 표시된 원인을 해결하고 재점검합니다. 보호 설정을 해제하지 마세요.