[Spring] WSL Ubuntu 내부에 Docker CLI 와 docker compose 플러그인 설치 방법

민지·2025년 7월 28일

Spring

목록 보기

28/37

Command 'make' not found, but can be installed with:
sudo apt install make # version 4.3-4.1build1, or
sudo apt install make-guile # version 4.3-4.1build1

Makefile 에 있는 도커 컴포즈 명령을 실행하려는데 make 명령 오류가 났다. Docker 는 Windows 에서 실행 중이고,
WSL Ubuntu 는 배포판만 연결된 상태이다.
그래서 Ubuntu 터미널에서 직접 docker 나 docker compose 같은 명령을 바로 쓸 수 있도록 환경 세팅을 해주려고 한다.

지금은 Windows PowerShell 에서만 docker 명령이 정상 작동.
하지만 WSL Ubuntu 안에서는 기본적으로 Docker CLI가 없어서 docker를 바로 쓸 수 없음.

🔨세팅 방법

1. Docker Desktop WSL 통합 확인

Docker Desktop → Settings → Resources → WSL Integration
→ Ubuntu 체크 ON → Apply & Restart.

2. Ubuntu 터미널에서 Docker CLI, docker compose 설치

# 1. 패키지 업데이트
sudo apt update
sudo apt upgrade -y

# 2. 필수 패키지 설치
sudo apt install -y ca-certificates curl gnupg lsb-release

# 3. Docker GPG 키 등록
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 4. Docker 저장소 추가
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 5. 패키지 갱신 & Docker CLI & docker compose 설치
sudo apt update
sudo apt install -y docker-ce-cli

3. 실행 테스트

which docker

정상적인 WSL-Docker 연동 상태라면
which docker 결과 경로가 /usr/bin/docker 혹은 /usr/local/bin/docker 이어야 한다.
그럼 성공!

만약 사진과 같다면 PATH를 수정해줘야 된다.
WSL(리눅스) 에 설치된 docker-cli 가 아니라 Windows 쪽 Docker Desktop의 docker.exe 를 WSL 에서 그대로 불러오고 있는 상태이다.

4. PATH 우선순위 수정

Windows docker.exe 대신 리눅스 docker가 먼저 잡히도록

echo 'export PATH="/usr/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

5. 실행 테스트

docker version

버전이 잘 출력되면 성공!

docker compose up -d
docker ps

컨테이너가 올라가면 성공! 인데

Docker 데몬 어쩌고 오류가 뜬다면

Docker CLI는 설치되어 있지만 Docker 데몬과 연결이 안된 상태 (Cannot connect to the Docker daemon at unix:///var/run/docker.sock 오류 )
Docker Desktop 의 데몬을 WSL 내부에서 못 쓰고 있는 상태이다.