인프런 커뮤니티 질문&답변

진수님, 안녕하세요?

아래 AI 인턴이 답을 잘 해놓았는데 다시 한번 답변 남겨놓겠습니다.

같은 증상을 겪는 경우가 꽤 있어서, 걱정하실 만한 오류는 아니에요.
한마디로 말하면, 재부팅 이후에 “Docker Desktop ↔ WSL2(Ubuntu)” 연결이 잠깐 끊겼다가, Refetch로 다시 붙은 상황입니다.

WSL2 Ubuntu 안에서 docker compose up -d를 실행할 때

The command 'docker' could not be found in this WSL 2 distro.
We recommend to activate the WSL integration in Docker Desktop settings.

이 메시지가 뜨는 이유는, WSL 쪽에서 docker 명령을 못 찾을 때 나오는 표준 안내입니다.
주로 다음 상황에서 발생합니다.

• Docker Desktop은 켜져 있는데, 해당 Ubuntu 배포판에 대한 WSL Integration이 꺼져 있거나,

• Windows/Docker Desktop/WSL 업데이트 이후에 “어느 WSL 배포판과 연동할지” 정보가 잠깐 꼬였을 때.

말씀하신 것처럼
Docker Desktop → Settings → Resources → WSL integration 에서 Refetch distros를 누르면,
Docker가 다시 한 번 “현재 설치된 WSL 배포판 목록”을 스캔하고, 그 배포판(Ubuntu 등)에 docker 클라이언트를 다시 연결해 줍니다.
그래서 버튼 한 번으로 해결된 거고, 동작 자체는 정상이에요.

앞으로 같은 증상이 다시 나올 수 있어서(저는 OpenClaw이외에 윈도우즈나 도커 데스크탑은 업데이트를 자주 하는편이 아니라 아직 발생하지 않았을수도 있습니다),

그럴 때는 아래 순서대로 확인해 보시면 됩니다.

• Docker Desktop이 먼저 실행 중인지 확인합니다. (시스템 트레이 고래 아이콘이 Running 상태인지)

• WSL2 Ubuntu 터미널에서 docker --version을 쳤을 때, 같은 에러가 나오면 WSL Integration 문제로 봐도 됩니다.

• Docker Desktop → Settings → Resources → WSL integration에서

  • “Use WSL 2 based engine”이 켜져 있는지,

  • 사용 중인 Ubuntu 배포판 옆 토글이 켜져 있는지 확인하고, 이상하면 Refetch distros 후 다시 체크합니다.

• 필요하면 PowerShell에서 wsl --shutdown으로 WSL을 한 번 완전히 끄고, Docker Desktop을 재시작한 뒤 Ubuntu 터미널을 다시 열어 봅니다.

정리하면, 이번 오류는 환경설정이 망가진 게 아니라, 재부팅/업데이트 이후에 WSL 연동이 잠깐 끊긴 것에 가깝고,
지금처럼 WSL Integration 탭에서 다시 연결해 주면 정상입니다. 같은 현상이 반복되면 위 체크리스트를 한 번씩 따라가 보시면 됩니다.

감사합니다.

안녕하세요, 인프런 AI 인턴입니다. 하진수님.

WSL 2와 Docker를 사용할 때 발생하는 오류는 종종 Docker Desktop 설정에서 WSL 통합이 올바르게 설정되지 않아서 발생할 수 있습니다. 이번 경우도 그와 관련이 있어 보입니다. 아래는 문제 해결을 위한 몇 가지 확인 사항입니다:

문제 해결 방법

1. WSL 2 통합 확인

   • Docker Desktop > Settings > Resources > WSL Integration에서 원하는 Linux 배포판이 Docker와 통합되도록 설정되어 있는지 확인하세요.
     
   • 해당 설정에서 문제가 있는 WSL 배포판을 선택하고, 재시작 후에도 동일한 오류가 발생하는지를 확인합니다.
     

2. Docker 및 WSL 버전 확인

   • 사용하고 있는 Docker Desktop과 WSL의 최신 버전을 사용하고 있는지 확인하세요. 구버전은 호환성 이슈를 발생할 수 있습니다.
     

3. WSL 2 재설치

   • 경우에 따라 WSL 2 자체의 문제일 수도 있습니다. WSL을 재설치하여 환경설정을 새로이 해보는 것도 하나의 방법입니다.
     

4. Docker Desktop 업데이트

   • Docker Desktop을 최신 버전으로 업데이트하여, 버전 호환성 및 설정 관련 오류를 사전에 방지합니다.
     

5. Docker 재시작

   • Docker Desktop 뿐만 아니라, 컴퓨터 자체를 재부팅 후, docker-compose 명령어를 다시 시도해 보세요. 시스템 환경 변수 설정이 재적용될 수 있습니다.
     

문제 해결을 위한 더 자세한 정보는 Docker 공식 문서의 WSL 2 사용 가이드를 참조하세요.

질문자님의 편의를 위해 위의 방법들이 도움이 되었기를 바랍니다. 여전히 문제가 해결되지 않는 경우 추가 정보를 주시면 더 자세히 도와드리겠습니다.

저는 질문자님의 이해를 돕고자 Docker와 관련한 정보를 제공해드렸습니다. 현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏 추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.