[WSL 2] Docker Desktop 없이 Ubuntu에 순수 도커(Docker Engine) 직접 설치하기

Windows 환경에서 무거운 Docker Desktop 프로그램을 실행하지 않고, WSL 2(Ubuntu) 내부에 직접 Linux 네이티브 Docker 엔진과 Docker Compose를 설치하여 가볍게 구동하는 가이드입니다.

 

1. WSL 2 systemd 활성화 (필수)

WSL 2 환경에서 Docker 데몬(dockerd)이 백그라운드 서비스로 정상 실행되려면 systemd 지원이 활성화되어 있어야 합니다.

Ubuntu 터미널을 열고 /etc/wsl.conf 파일을 수정합니다.

Bash

 

sudo nano /etc/wsl.conf

편집기 화면에 아래 설정을 입력합니다.

Ini, TOML

 

[boot]
systemd=true

• Ctrl + O 누른 뒤 Enter (저장)
• Ctrl + X (종료)

설정을 반영하기 위해 Windows PowerShell을 열고 WSL을 완전히 종료했다가 다시 켭니다.

PowerShell

 

wsl --shutdown

종료 후 다시 Ubuntu 터미널을 실행합니다.

 

2. 필수 패키지 설치

기존 패키지 인덱스를 갱신하고, HTTPS 저장소 통신에 필요한 도구를 설치합니다.

Bash

 

sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg lsb-release

 

3. Docker 공식 GPG 키 및 저장소(Repository) 등록

우분투 기본 저장소 버전 대신, Docker 공식 저장소의 최신 안정화 버전을 바라보도록 설정합니다.

Bash

 

# GPG 키 저장 디렉토리 생성
sudo install -m 0755 -d /etc/apt/keyrings

# Docker 공식 GPG 키 다운로드
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# 공식 저장소 소스 리스트 등록
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 저장소 목록 갱신
sudo apt-get update

 

4. Docker Engine 및 Docker Compose 플러그인 설치

도커 핵심 엔진과 CLI 도구, 최신 Docker Compose 플러그인을 함께 설치합니다.

Bash

 

sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

 

5. non-root 사용자 권한 부여 (sudo 없이 실행)

기본 상태에서는 매번 sudo docker를 입력해야 합니다. 현재 로그인된 사용자 계정을 docker 그룹에 추가하여 권한을 부여합니다.

Bash

 

# 현재 사용자를 docker 그룹에 추가
sudo usermod -aG docker $USER

# 변경된 그룹 권한 즉시 적용
newgrp docker

 

6. 도커 동작 테스트

도커 서비스가 정상 기동 중인지 확인하고 컨테이너 목록 명령어를 테스트합니다.

Bash

 

# 서비스 상태 확인
sudo systemctl status docker

# 컨테이너 목록 출력 확인
docker ps

아래와 같이 빈 헤더가 정상 출력되면 모든 설정이 완료된 상태입니다.

 

Plaintext

 

CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES

버전 확인:

Bash

 

docker --version
docker compose version