Docker Desktop에서 저장공간을 확보(Clear)하는 방법

Docker Desktop에서 저장공간을 확보(Clear)하는 방법은 크게 GUI(설정 화면)를 이용하는 방법과 터미널 명령어(CLI)를 이용하는 방법 두 가지가 있습니다.

상황에 맞게 선택해서 사용하세요.

방법 1. Docker Desktop GUI 기능 사용 (가장 간편)

Docker Desktop 자체 기능을 이용해 사용하지 않는 데이터나 모든 데이터를 삭제할 수 있습니다.

1. “Disk usage” 확장 기능 활용 (공간 관리)
최신 Docker Desktop에는 저장공간 관리 툴이 내장되어 있습니다.

• Docker Desktop 실행

• 왼쪽 사이드바의 Dashboard에서 Extensions 혹은 메뉴 목록 중 “Disk usage” 클릭 (안 보이면 Add Extensions에서 검색)

• 여기서 이미지(Images), 빌드 캐시(Build Cache), 볼륨(Volumes) 중 용량을 많이 차지하는 것을 선택하여 “Reclaim space” 버튼을 누르면 됩니다.

2. Troubleshoot 메뉴 이용 (전체 초기화)
가장 확실하게 “공장 초기화” 수준으로 비우고 싶을 때 사용합니다.

• 오른쪽 상단 벌레 모양 아이콘 (Troubleshoot) 클릭

• “Clean / Purge data” 선택

• 원하는 항목 체크:

  • Disk image: 모든 이미지와 컨테이너 삭제 (가장 용량 확보가 큼)

  • Container/Images: 컨테이너와 이미지만 삭제

  • Volumes: 볼륨 데이터 삭제 (DB 데이터 등 사라짐 주의)

• Delete 클릭

방법 2. 명령어(CLI) 사용 (세밀한 삭제)

터미널(PowerShell, CMD, Terminal)에서 직접 명령어를 입력하여 삭제하는 표준적인 방법입니다.

1. 사용하지 않는 모든 데이터 삭제 (가장 추천)
중지된 컨테이너, 사용 안 하는 네트워크, 댕글링(이름 없는) 이미지를 한방에 지웁니다.

docker system prune

2. 사용 중이지 않은 “모든” 이미지 및 볼륨까지 삭제 (강력한 청소)
위 명령어보다 더 강력합니다. 현재 실행 중인 컨테이너가 사용하지 않는 모든 이미지와 볼륨까지 지웁니다.
(주의: DB 데이터 등이 볼륨에 저장되어 있다면 사라집니다)

docker system prune -a --volumes

• -a: 사용되지 않는 모든 이미지 삭제 (기본은 <none> 태그 이미지 만 삭제됨)

• –volumes: 사용되지 않는 볼륨까지 삭제

방법 3. Windows(WSL2) 사용자의 경우 (특수 상황)

Docker Desktop for Windows(WSL2 백엔드)를 사용하는 경우, 내부적으로 데이터를 지워도 윈도우 탐색기에서 보이는 ext4.vhdx 파일 용량이 즉시 줄어들지 않을 때가 있습니다.

이때는 **PowerShell(관리자 권한)**에서 강제로 디스크를 압축해야 합니다.

1. Docker Desktop 종료 (Quit Docker Desktop)

2. PowerShell(관리자) 열기

3. 아래 명령어 순서대로 입력:

   codePowershell

   # Docker WSL 종료
   wsl --shutdown
   
   # 디스크 파일 위치 찾기 (보통 아래 경로에 있음, 사용자명 부분 확인 필요)
   # cd C:\Users\[사용자명]\AppData\Local\Docker\wsl\data\
   
   # diskpart 실행하여 압축 (경로는 본인 PC 상황에 맞게 수정)
   diskpart
   # (새로운 창이 뜨면 아래 입력)
   select vdisk file="C:\Users\[사용자명]\AppData\Local\Docker\wsl\data\ext4.vhdx"
   compact vdisk
   exit

요약

• 빠른 정리: 터미널에서 docker system prune -a

• 완전 초기화: Docker Desktop 상단 벌레 아이콘 -> Clean / Purge data