Docker 설치 후 기본 트러블슈팅 및 WSL2 가이드
Docker Desktop 설치가 끝났는데 고래 아이콘이 빨간색인가요? 자주 발생하는 초기 문제들을 해결해 봅시다.
1. Windows WSL2 관련 문제
증상: "Docker Desktop requires a newer WSL kernel version" 에러
원인: Windows의 리눅스 서브시스템 커널이 최신이 아닙니다.
해결: 터미널을 관리자 권한으로 열고 커널을 업데이트하세요.
wsl --update
2. macOS 권한 및 실행 문제
증상: "Docker is not running" 또는 권한 에러
원인: 시스템 설정에서 Docker의 백그라운드 실행을 차단했거나 권한이 부족합니다.
해결: [시스템 설정] -> [개인정보 보호 및 보안]에서 Docker 관련 항목을 허용하고, Docker Desktop을 재시작하세요.
3. 컨테이너 대체 도구 (사내 보안 정책 대응)
증상: 유료화 또는 보안 정책으로 Docker Desktop 사용 불가
해결: Colima(macOS) 또는 Podman(Windows/macOS)과 같은 훌륭한 오픈소스 대안을 사용하세요.
# macOS에서 Colima 설치
brew install colima docker
colima start
brew install colima docker
colima start
1분 확인 커맨드
docker version
docker run hello-world
docker run hello-world