Docker Desktop 없이 WSL2에 직접 Docker 설치하기

Docker Desktop은 편리하지만, 시스템 리소스를 많이 차지하거나 라이선스 문제로 인해 사용을 꺼리는 경우가 있습니다. 

따라서 이번에는 Docker Desktop을 사용하지 않고 WSL2 환경에 직접 Docker를 설치하는 방법을 소개하고자 합니다.

 

---

1. 패키지 업데이트 및 필수 패키지 설치

먼저 WSL2 터미널을 열고 아래 명령어를 실행하여 패키지를 최신 상태로 업데이트합니다.

sudo apt update

 

Docker 설치에 필요한 필수 패키지를 설치합니다.

sudo apt install -y apt-transport-https ca-certificates curl software-properties-common

2. Docker 공식 GPG 키 추가

Docker 저장소를 신뢰할 수 있도록 GPG 키를 추가합니다.

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

3. Docker 저장소 추가

Ubuntu에서 Docker 패키지를 설치할 수 있도록 Docker의 공식 저장소를 추가합니다.

sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

4. 패키지 업데이트 및 Docker 설치

추가한 저장소를 기반으로 패키지 목록을 업데이트한 후 Docker를 설치합니다.

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io

5. Docker 서비스 시작 및 사용자 설정

Docker 서비스가 실행되도록 시작하고, 현재 사용자를 docker 그룹에 추가하여 sudo 없이 Docker 명령어를 사용할 수 있도록 설정합니다.

sudo service docker start
sudo usermod -aG docker $USER

이 명령어 실행 후 WSL2 터미널을 재시작하거나 로그아웃 후 다시 로그인해야 변경 사항이 적용됩니다.

6. Docker 설치 확인

Docker가 정상적으로 설치되었는지 확인하는 방법입니다.

1) Docker 버전 확인

docker --version

 

정상적으로 설치되었다면 버전 정보가 출력됩니다.

2) Docker 데몬 상태 확인

docker info

Docker 데몬의 상세 정보가 표시되면 정상적으로 실행 중인 것입니다.

3) Docker 테스트 컨테이너 실행

docker run hello-world

 

이 명령어가 성공적으로 실행되면 다음과 같은 메시지가 출력됩니다:

Hello from Docker!
This message shows that your installation appears to be working correctly.

7. Docker 예제: 간단한 웹 서버 실행

Docker를 활용하여 Nginx 웹 서버를 실행하는 예제입니다.

# Nginx 컨테이너 실행 (포트 8080 → 80 매핑)
docker run -d -p 8080:80 --name my-nginx nginx

# 실행 중인 컨테이너 확인
docker ps

# 웹 브라우저에서 확인: http://localhost:8080 또는 아래 명령어 실행
curl http://localhost:8080

웹 브라우저에서 http://localhost:8080에 접속하면 Nginx 기본 페이지가 표시됩니다.

 

컨테이너를 중지하고 삭제하는 방법:

# 컨테이너 중지
docker stop my-nginx

# 컨테이너 삭제
docker rm my-nginx

8. Docker Desktop 삭제 방법

WSL2에 직접 Docker 엔진을 설치했다면 기존의 Docker Desktop은 더 이상 필요하지 않습니다. 다음 방법으로 삭제할 수 있습니다.

1) Windows 설정에서 삭제

1. Windows 시작 메뉴 → 설정(Settings) → 앱(Apps) → 앱 및 기능(Apps & features) 이동
2. 목록에서 "Docker Desktop" 찾기
3. 제거(Uninstall) 버튼 클릭 후 화면 지시에 따라 진행

2) 제어판에서 삭제

1. 제어판 → 프로그램 → 프로그램 및 기능 이동
2. 목록에서 "Docker Desktop"을 찾아 우클릭
3. 제거(Uninstall) 선택 후 지시에 따라 진행

3) 제거 후 재부팅

삭제 과정이 완료되면 시스템을 재부팅하는 것이 좋습니다.

Docker Desktop을 제거한 후에도 WSL2에 직접 설치한 Docker 엔진을 계속 사용할 수 있습니다. 이를 통해 불필요한 시스템 리소스 사용을 줄이면서 가볍고 효율적인 Docker 환경을 구축할 수 있습니다.

 

---

이렇게 설정한다면 WSL2 환경에서 Docker Desktop 없이도 Docker를 활용하여 컨테이너를 실행할 수 있습니다.