“이 포스팅은 제휴마케팅이 포함된 광고로 커미션을 지급 받습니다.”

Docker Desktop 설치 방법

Docker Desktop 설치는 공식 Docker 사이트에서 운영체제와 프로세서에 맞는 설치 파일을 내려받아 실행하면 됩니다. Windows에서는 WSL 2 기반 사용을 권장하며, Mac에서는 Apple Silicon과 Intel 프로세서를 구분해야 합니다. Linux에서는 지원 배포판에 맞는 패키지를 설치합니다.

Docker Desktop은 Docker Engine, Docker CLI, Docker Compose와 컨테이너 관리 화면을 하나로 제공하는 데스크톱 애플리케이션입니다. 설치가 완료되면 별도의 Docker Compose 설치 없이 이미지 빌드, 컨테이너 실행, 로그 확인 및 볼륨 관리 같은 작업을 시작할 수 있습니다. Docker 공식 문서는 Docker Desktop을 이미지 빌드와 컨테이너 실행에 필요한 도구를 통합한 패키지로 설명합니다.

이 글에서는 Windows, macOS, Linux에서 Docker Desktop을 설치하는 방법과 WSL 2 설정, 설치 확인, 첫 컨테이너 실행 및 자주 발생하는 오류 해결 방법을 단계별로 설명합니다.

Docker Desktop이란?

Docker는 애플리케이션과 실행에 필요한 라이브러리, 설정을 컨테이너라는 격리된 단위로 묶어 실행할 수 있게 해주는 플랫폼입니다.

컨테이너를 이용하면 개발자의 컴퓨터에서 정상적으로 작동한 애플리케이션을 테스트 서버나 운영 서버에서도 비교적 일관된 환경으로 실행할 수 있습니다.

Docker Desktop에는 일반적으로 다음 구성 요소와 기능이 포함됩니다.

Docker Engine
Docker CLI
Docker Compose
이미지와 컨테이너 관리 화면
볼륨과 네트워크 관리
Kubernetes 관련 선택 기능
확장 기능
WSL 2 연동
개발 환경 및 로그 확인 기능

Docker Engine은 컨테이너를 생성하고 실행하는 핵심 기술입니다. Docker Desktop은 이 엔진과 명령줄 도구, Compose 및 그래픽 관리 기능을 데스크톱 운영체제에서 편리하게 사용할 수 있도록 묶은 제품입니다.

Docker Desktop과 Docker Engine의 차이

두 제품은 관련되어 있지만 설치 방식과 사용 환경이 다릅니다.

구분	Docker Desktop	Docker Engine
주요 환경	Windows, macOS, Linux 데스크톱	주로 Linux 서버
관리 화면	제공	기본적으로 제공하지 않음
Docker Compose	함께 제공	별도 플러그인 설치 가능
가상화 계층	운영체제에 따라 사용	Linux에서 직접 실행
추천 대상	개발자와 입문자	서버 관리자와 Linux 사용자
업데이트	Desktop 앱에서 관리	패키지 관리자로 관리

Windows와 macOS에서 로컬 개발을 시작하려면 Docker Desktop이 편리합니다. GUI가 필요 없는 Linux 서버에서는 Docker Engine만 설치하는 경우가 일반적입니다.

Docker Desktop 설치 전 확인 사항

설치 전에 운영체제, 프로세서, 메모리, 가상화 기능 및 회사의 라이선스 정책을 확인해야 합니다.

공통 준비 항목

다음 항목을 먼저 확인하세요.

지원되는 64비트 운영체제
하드웨어 가상화를 지원하는 CPU
충분한 메모리와 저장 공간
관리자 권한
안정적인 인터넷 연결
공식 Docker 설치 파일
회사 또는 기관의 Docker Desktop 이용 정책

컨테이너 이미지의 크기는 프로젝트마다 다릅니다. 여러 이미지를 내려받거나 데이터베이스 컨테이너를 실행하면 저장 공간 사용량이 빠르게 증가할 수 있으므로 시스템 드라이브에 충분한 여유 공간을 확보하세요.

Windows에서 가상화 확인하기

Windows에서는 작업 관리자를 열고 다음 경로에서 가상화 상태를 확인할 수 있습니다.

작업 관리자 → 성능 → CPU → 가상화

“사용”으로 표시되면 일반적으로 하드웨어 가상화가 활성화된 상태입니다. “사용 안 함”으로 표시되면 BIOS 또는 UEFI 설정에서 Intel Virtualization Technology, Intel VT-x, AMD-V 또는 SVM Mode를 활성화해야 할 수 있습니다.

메뉴 이름과 BIOS 진입 방법은 PC 제조사마다 다릅니다. 가상화 기능 외의 설정을 임의로 변경하면 부팅 문제가 발생할 수 있으므로 주의하세요.

Docker Desktop은 무료인가요?

Docker Desktop은 모든 환경에서 무조건 무료인 프로그램은 아닙니다.

다음 용도에서는 무료로 사용할 수 있습니다.

개인적 사용
교육 목적
비상업적 오픈소스 프로젝트
직원 수가 250명 미만이면서 연 매출이 미화 1,000만 달러 미만인 소규모 기업

규모가 더 큰 조직에서의 전문적 사용, 정부 기관 및 무료 조건을 벗어나는 상업적 이용에는 유료 구독이 필요합니다. Docker Pro, Team 및 Business 플랜에는 Docker Desktop 사용 권한이 포함됩니다. 설치 전 현재 조직의 규모와 이용 목적을 확인해야 합니다.

무료 이용 조건을 충족하더라도 Docker Hub의 이미지 가져오기 횟수나 일부 클라우드 기능에는 계정 또는 플랜별 제한이 적용될 수 있습니다.

Windows에 Docker Desktop 설치하기

Windows에서는 WSL 2 백엔드를 이용하는 방법이 일반적입니다. WSL은 Windows에서 Linux 환경을 실행할 수 있도록 제공되는 기능입니다.

1단계: WSL 상태 확인

PowerShell 또는 명령 프롬프트를 열고 다음 명령을 실행합니다.

wsl --version

Docker 공식 문서는 Docker Desktop의 WSL 2 기능을 사용하려면 최소 WSL 2.1.5가 필요하며, 예상치 못한 문제를 줄이기 위해 최신 WSL 사용을 권장합니다.

WSL이 설치되지 않았다면 관리자 권한 PowerShell에서 다음 명령을 사용할 수 있습니다.

wsl --install

설치가 완료되면 Windows를 재부팅해야 할 수 있습니다.

이미 WSL이 설치되어 있다면 다음 명령으로 업데이트합니다.

wsl --update

2단계: 공식 설치 파일 다운로드

Docker 공식 Windows 설치 페이지에서 Docker Desktop Installer를 내려받습니다. Intel 또는 AMD 기반의 일반적인 PC와 ARM 기반 Windows 기기의 설치 파일이 구분될 수 있으므로 시스템 종류를 확인하세요.

3단계: 설치 프로그램 실행

다운로드한 설치 파일을 실행합니다. 사용자 계정 컨트롤 창이 나타나면 게시자를 확인하고 예를 선택합니다.

설치 옵션에서 WSL 2 사용 여부가 표시되면 특별한 호환성 요구 사항이 없는 일반 사용자는 WSL 2 기반 옵션을 선택하는 것이 적절합니다.

Docker Desktop이 실행되기 전에 WSL 2가 시스템에 활성화되어 있어야 하며, 이 과정은 컴퓨터마다 한 번만 설정하면 됩니다.

4단계: Windows 재부팅

설치 마법사의 안내에 따라 설치를 완료합니다. 로그아웃이나 재부팅을 요구하면 실행 중인 작업을 저장한 뒤 진행하세요.

5단계: 이용 약관 확인

Docker Desktop을 처음 실행하면 서비스 이용 약관 확인 화면이 나타날 수 있습니다. 현재 사용 목적과 조직이 무료 조건에 해당하는지 확인한 뒤 동의합니다.

Windows Home에서도 사용할 수 있나요?

지원되는 Windows 버전과 WSL 2 요구 사항을 충족하면 사용할 수 있습니다. 다만 Windows 컨테이너 기능은 Windows 에디션과 구성에 따라 제한될 수 있습니다.

일반적인 웹 애플리케이션, 데이터베이스 및 Linux 기반 개발 환경은 Linux 컨테이너 모드와 WSL 2를 사용하면 됩니다.

macOS에 Docker Desktop 설치하기

Mac에서는 사용하는 프로세서에 맞는 버전을 선택해야 합니다.

Mac 프로세서 확인 방법

화면 왼쪽 위의 Apple 메뉴에서 이 Mac에 관하여를 엽니다.

Apple M1, M2, M3, M4 등이 표시되면 Apple Silicon
Intel이 표시되면 Intel 기반 Mac

프로세서와 맞지 않는 설치 파일을 받으면 설치되지 않거나 실행 과정에서 문제가 발생할 수 있습니다.

macOS 설치 단계

Docker Desktop 공식 Mac 설치 페이지를 엽니다.
Apple Silicon 또는 Intel 버전을 선택합니다.
.dmg 설치 파일을 내려받습니다.
다운로드한 파일을 엽니다.
Docker 아이콘을 Applications 폴더로 이동합니다.
응용 프로그램에서 Docker를 실행합니다.
필요한 권한 요청을 확인합니다.
이용 약관을 검토하고 동의합니다.
메뉴 막대에 고래 모양 아이콘이 표시되는지 확인합니다.

Docker Desktop은 필요한 경우에만 macOS 관리자 권한을 요청하도록 설계되어 있습니다. 권한 요청이 나타나면 요구되는 기능과 내용을 확인한 후 승인하세요.

Apple Silicon에서 주의할 점

Apple Silicon Mac은 ARM 아키텍처를 사용합니다. ARM64 이미지를 사용하면 일반적으로 효율적이며, x86_64 전용 이미지는 에뮬레이션이 필요해 속도가 느려지거나 호환성 문제가 발생할 수 있습니다.

이미지를 내려받기 전에 Docker Hub 페이지에서 linux/arm64 지원 여부를 확인하는 것이 좋습니다.

Linux에 Docker Desktop 설치하기

Docker Desktop은 Linux에서도 사용할 수 있지만, 서버 환경이라면 Docker Engine만 설치하는 방식이 더 적합할 수 있습니다.

Docker Desktop for Linux는 지원되는 배포판과 시스템 요구 사항을 충족해야 하며, 별도의 가상 머신 환경에서 컨테이너를 실행합니다.

Ubuntu 설치 예시

Ubuntu에서는 Docker의 패키지 저장소를 설정한 다음 최신 .deb 패키지를 내려받아 설치하는 방식이 권장됩니다.

다운로드 폴더에서 다음 명령을 실행합니다.

sudo apt-get update
sudo apt install ./docker-desktop-amd64.deb

실제 파일 이름이나 경로가 다르면 명령을 알맞게 수정해야 합니다. Docker 공식 Ubuntu 문서도 저장소 설정 후 최신 DEB 패키지를 내려받아 apt로 설치하는 절차를 안내합니다.

설치가 끝나면 애플리케이션 메뉴에서 Docker Desktop을 실행하거나 사용자 서비스로 시작할 수 있습니다.

Linux에서 Docker Engine이 더 적합한 경우

다음 환경에서는 Docker Desktop보다 Docker Engine 설치를 먼저 검토하세요.

GUI가 없는 원격 서버
클라우드 가상 머신
CI/CD 실행 서버
최소 구성의 Linux 시스템
데스크톱 관리 화면이 필요하지 않은 환경

Docker Desktop과 시스템에 직접 설치한 Docker Engine을 동시에 구성하면 명령이 서로 다른 Docker 컨텍스트를 가리킬 수 있습니다. 설치 후 docker context ls로 현재 연결 대상을 확인하는 것이 좋습니다.

Docker Desktop 설치 확인 방법

설치가 끝나면 터미널, PowerShell 또는 명령 프롬프트에서 다음 명령을 실행합니다.

docker --version

Docker Compose 버전도 확인합니다.

docker compose version

Docker Desktop에는 Docker Compose가 포함되므로 일반적으로 별도로 Compose를 설치할 필요가 없습니다. 최신 방식은 하이픈이 없는 docker compose 명령입니다.

클라이언트와 서버 연결 상태를 확인하려면 다음 명령을 사용합니다.

docker info

서버 정보까지 정상적으로 출력되면 Docker Engine이 실행 중인 상태입니다.

Cannot connect to the Docker daemon 오류가 나타나면 Docker Desktop이 완전히 시작됐는지 확인하세요.

첫 Docker 컨테이너 실행하기

설치가 정상인지 간단하게 확인하려면 hello-world 이미지를 실행합니다.

docker run hello-world

이 명령은 다음 작업을 수행합니다.

로컬에 hello-world 이미지가 있는지 확인합니다.
이미지가 없으면 레지스트리에서 내려받습니다.
이미지로 새 컨테이너를 생성합니다.
컨테이너 안의 테스트 메시지를 출력합니다.
실행이 끝나면 컨테이너가 종료됩니다.

실행된 컨테이너 목록을 확인하려면 다음 명령을 사용합니다.

docker ps -a

내려받은 이미지 목록은 다음 명령으로 확인합니다.

docker images

더 이상 필요하지 않은 테스트 컨테이너는 해당 컨테이너 ID를 확인한 뒤 삭제할 수 있습니다.

docker rm 컨테이너_ID

이미지도 사용하지 않는다면 다음 명령으로 삭제합니다.

docker rmi hello-world

웹 서버 컨테이너 실행하기

간단한 Nginx 웹 서버를 실행하려면 다음 명령을 사용할 수 있습니다.

docker run --name test-nginx -d -p 8080:80 nginx

명령의 의미는 다음과 같습니다.

--name test-nginx: 컨테이너 이름 지정
-d: 백그라운드 실행
-p 8080:80: 호스트의 8080 포트를 컨테이너의 80 포트와 연결
nginx: 사용할 이미지 이름

웹 브라우저에서 localhost:8080을 열어 Nginx 시작 화면이 나타나는지 확인합니다.

테스트가 끝나면 다음 명령으로 컨테이너를 중지하고 삭제합니다.

docker stop test-nginx
docker rm test-nginx

인터넷에서 받은 이미지는 신뢰성과 유지 관리 상태를 확인해야 합니다. 중요한 환경에서는 공식 이미지나 검증된 게시자의 이미지를 우선 사용하세요.

Docker Desktop 설치 후 추천 설정

Docker Desktop의 Settings 메뉴에서는 시작 옵션, CPU, 메모리, 디스크, 파일 공유 및 WSL 연동을 조정할 수 있습니다.

자동 실행 설정

컴퓨터를 켤 때마다 Docker를 사용하지 않는다면 자동 시작을 끄는 것이 부팅 시간과 메모리 사용량을 줄이는 데 도움이 될 수 있습니다.

Docker를 매일 사용하는 개발 환경이라면 자동 실행을 켜는 것이 편리합니다.

CPU와 메모리 설정

컨테이너에 지나치게 많은 자원을 제공하면 호스트 운영체제가 느려질 수 있습니다. 반대로 메모리가 너무 적으면 데이터베이스나 빌드 작업이 중단될 수 있습니다.

처음에는 기본값을 유지하고 다음 상황에서 조정하세요.

대규모 이미지를 빌드할 때
데이터베이스 컨테이너를 여러 개 실행할 때
Kubernetes 기능을 사용할 때
메모리 부족 오류가 발생할 때
호스트 컴퓨터가 지나치게 느려질 때

Mac의 Docker VMM 기능을 사용할 경우 Docker Linux VM에 최소 4GB 메모리 할당이 필요합니다.

디스크 사용량 확인

사용하지 않는 이미지, 정지된 컨테이너, 빌드 캐시와 볼륨은 저장 공간을 계속 차지할 수 있습니다.

현재 사용량은 다음 명령으로 확인합니다.

docker system df

사용하지 않는 리소스를 정리할 때는 다음 명령을 사용할 수 있습니다.

docker system prune

볼륨까지 삭제하는 옵션은 데이터베이스 파일이나 프로젝트 데이터를 제거할 수 있으므로 내용을 확인하지 않고 실행해서는 안 됩니다.

Windows에서 WSL 2와 Docker 연동하기

Windows에서 Ubuntu 같은 WSL 배포판을 사용한다면 Docker Desktop의 WSL Integration 기능을 활성화할 수 있습니다.

Docker Desktop을 실행합니다.
Settings를 엽니다.
Resources → WSL Integration으로 이동합니다.
사용할 Linux 배포판을 활성화합니다.
설정을 적용하고 Docker Desktop을 다시 시작합니다.

공식 문서는 WSL 배포판에서 개발하기 전에 Docker Desktop의 WSL Integration 설정이 활성화되어 있어야 한다고 안내합니다.

WSL 터미널에서 다음 명령을 실행해 연결 상태를 확인합니다.

docker version

프로젝트 성능을 높이려면 Windows 파일 시스템의 마운트 경로보다 WSL의 Linux 파일 시스템 안에 프로젝트를 저장하는 것이 유리한 경우가 있습니다. Docker는 WSL 2 사용 시 최신 WSL 유지, 파일 시스템 성능 및 CPU·메모리 제한에 관한 별도 권장 사항을 제공합니다.

Docker Desktop 설치 오류 해결 방법

Docker Desktop이 시작되지 않을 때

다음 순서로 확인하세요.

운영체제를 업데이트합니다.
PC를 재부팅합니다.
BIOS 또는 UEFI에서 가상화가 활성화됐는지 확인합니다.
Windows에서는 wsl --status를 실행합니다.
WSL을 최신 버전으로 업데이트합니다.
Docker Desktop을 관리자 권한으로 다시 실행합니다.
보안 프로그램과 회사 정책의 차단 여부를 확인합니다.
Docker Desktop의 문제 해결 메뉴에서 진단 정보를 확인합니다.

WSL 2 설치 또는 업데이트 오류

관리자 권한 PowerShell에서 다음 명령을 차례로 확인합니다.

wsl --status
wsl --version
wsl --update

업데이트 후에는 다음 명령으로 WSL을 종료한 뒤 Docker Desktop을 다시 실행할 수 있습니다.

wsl --shutdown

Docker Desktop은 WSL 2.1.5 이상을 요구하므로 오래된 스토어 외부 WSL 버전을 사용하는 PC에서는 업데이트가 필요할 수 있습니다.

Hardware assisted virtualization 오류

가상화 기능이 꺼져 있거나 다른 가상화 프로그램의 설정과 충돌할 때 발생할 수 있습니다.

작업 관리자에서 가상화 상태를 확인하고 BIOS 또는 UEFI 설정을 점검하세요. 회사에서 관리하는 PC라면 보안 정책 때문에 사용자가 직접 변경하지 못할 수 있습니다.

Docker daemon에 연결할 수 없을 때

다음과 같은 오류가 대표적입니다.

Cannot connect to the Docker daemon

Docker Desktop의 상태가 Running인지 확인합니다. Windows에서는 현재 명령이 올바른 Docker 컨텍스트를 가리키는지도 확인하세요.

docker context ls

필요한 컨텍스트로 전환하려면 다음 형식의 명령을 사용합니다.

docker context use 컨텍스트_이름

포트가 이미 사용 중이라는 오류

Bind for 0.0.0.0:8080 failed와 비슷한 오류가 나타나면 다른 프로그램이나 컨테이너가 해당 포트를 사용 중일 수 있습니다.

실행 중인 컨테이너를 확인합니다.

docker ps

기존 컨테이너를 중지하거나 다른 호스트 포트를 지정하세요.

docker run -d -p 8081:80 nginx

디스크 공간 부족 오류

불필요한 컨테이너와 이미지를 확인합니다.

docker system df
docker ps -a
docker images

중요한 볼륨이 있는지 확인한 후 불필요한 리소스를 정리하세요. 데이터베이스 컨테이너의 볼륨을 삭제하면 저장된 데이터도 사라질 수 있습니다.

Mac에서 설치 파일이 열리지 않을 때

Apple Silicon과 Intel 중 올바른 버전을 받았는지 확인합니다. 다운로드가 중단되었거나 설치 파일이 손상됐을 가능성이 있다면 공식 페이지에서 다시 받으세요.

macOS 보안 경고가 나타난다면 시스템 설정의 개인정보 보호 및 보안 항목에서 앱 출처와 요청 내용을 확인합니다.

자주 묻는 질문

Docker Desktop은 회원가입 없이 사용할 수 있나요?

기본적인 로컬 컨테이너 작업은 로그인 없이 가능한 경우가 있지만, Docker Hub 이미지 사용량, 클라우드 기능 및 조직 정책에 따라 로그인이 필요할 수 있습니다. 회사 환경에서는 관리자가 조직 로그인을 요구할 수도 있습니다.

Windows에 Docker를 설치하려면 WSL 2가 꼭 필요한가요?

Linux 컨테이너 개발에서는 WSL 2 백엔드가 일반적으로 권장됩니다. 일부 환경에서는 Hyper-V 기반 구성이 가능하지만 Windows 에디션과 조직 설정에 따라 사용할 수 있는 기능이 달라집니다.

Docker Desktop에 Docker Compose도 포함되나요?

네. Docker Desktop은 Docker Compose를 함께 제공하므로 일반적으로 별도 설치가 필요하지 않습니다. 설치 후 docker compose version으로 확인할 수 있습니다.

Docker Desktop과 VirtualBox를 함께 사용할 수 있나요?

사용할 수 있는 환경도 있지만 하드웨어 가상화, Hyper-V 및 네트워크 설정에 따라 충돌하거나 성능이 달라질 수 있습니다. 두 프로그램을 동시에 실행하기 전에 각 제품의 현재 호환성 안내를 확인하세요.

Linux에서는 Docker Desktop과 Docker Engine 중 무엇이 좋나요?

그래픽 관리 화면, 확장 기능 및 데스크톱 통합이 필요하면 Docker Desktop이 편리합니다. 서버나 최소 구성 환경에서는 Docker Engine이 더 단순하고 적합할 수 있습니다.

설치 후 Docker 명령어가 인식되지 않는 이유는 무엇인가요?

Docker Desktop이 아직 실행되지 않았거나 PATH가 적용되지 않았을 수 있습니다. 터미널을 닫았다가 다시 열고 Docker Desktop의 실행 상태를 확인하세요.

Docker Desktop을 삭제하면 이미지와 컨테이너도 삭제되나요?

제거 방식과 선택한 데이터 삭제 옵션에 따라 달라집니다. 재설치 전에 필요한 이미지, 볼륨 및 데이터베이스 데이터를 백업하세요. 프로그램 제거 과정에서 Docker 데이터를 함께 삭제하면 복구하기 어려울 수 있습니다.

Docker 컨테이너는 가상 머신과 같은가요?

완전히 같지는 않습니다. 가상 머신은 일반적으로 전체 게스트 운영체제를 실행하지만 컨테이너는 호스트 커널을 공유하면서 애플리케이션과 필요한 구성 요소를 격리합니다. 따라서 컨테이너는 대체로 시작이 빠르고 상대적으로 가볍습니다.

결론

Docker Desktop 설치에서는 운영체제와 프로세서에 맞는 공식 설치 파일을 선택하는 것이 가장 중요합니다. Windows 사용자는 WSL 2를 설치하고 최신 상태로 유지해야 하며, Mac 사용자는 Apple Silicon과 Intel 버전을 구분해야 합니다. Linux 사용자는 지원 배포판과 Desktop이 필요한 환경인지 먼저 확인하세요.

설치 후에는 docker --version, docker compose version, docker run hello-world 명령으로 정상 작동 여부를 확인할 수 있습니다. Windows에서 WSL 배포판을 사용한다면 WSL Integration을 활성화하면 Linux 터미널과 VS Code에서 Docker 기반 프로젝트를 편리하게 개발할 수 있습니다.

기업이나 기관에서 사용하는 경우에는 설치 전 라이선스 조건을 반드시 확인해야 합니다. 또한 출처가 불분명한 컨테이너 이미지 사용을 피하고, 중요한 데이터는 Docker 볼륨에만 의존하지 말고 별도로 백업하는 것이 안전합니다.

GamsGo 프로모션 코드

Post Views: 10