본문으로 건너뛰기
콰이어트 노트QUIET NOTES

Docker 설치부터 첫 컨테이너 실행까지: 단계별 완벽 정리

콰이어트·약 9분 읽기
QUIET NOTES / CONTAINERS

메타 설명: Docker 초보자를 위한 설치 가이드입니다. Windows, Mac에서 Docker Desktop 설치 방법부터 hello-world 컨테이너 실행까지 10분 만에 완료할 수 있도록 단계별로 쉽게 설명합니다. 자주 발생하는 오류 해결법도 포함되어 있습니다.

들어가며

Docker를 처음 설치하려고 하시나요? 이 글에서는 Docker Desktop 설치부터 첫 번째 컨테이너를 실행하는 것까지 차근차근 안내해드립니다.

이 글에서 배울 것:

  • Docker Desktop 설치하기 (Windows / Mac)
  • 설치 확인하기
  • 첫 번째 컨테이너 실행하기

예상 소요 시간: 약 10~15분

필요한 것: 컴퓨터 (Windows 10/11 또는 Mac)

사전 준비

Docker란?

Docker는 애플리케이션을 “컨테이너”라는 독립된 환경에서 실행할 수 있게 해주는 도구입니다. 쉽게 말해, 내 컴퓨터에 가상의 작은 컴퓨터를 만들어서 프로그램을 실행하는 것과 비슷합니다.

💡 비유: Docker는 “밀키트”와 비슷합니다. 요리에 필요한 재료와 레시피가 모두 담겨 있어서, 누구나 동일한 결과물을 만들 수 있죠. Docker도 프로그램 실행에 필요한 모든 것이 담겨 있어서, 어떤 컴퓨터에서든 동일하게 실행됩니다.

시스템 요구사항

Windows:

  • Windows 10 버전 2004 이상 (빌드 19041 이상) 또는 Windows 11
  • 64비트 운영체제
  • 최소 4GB RAM

Mac:

  • macOS 11 (Big Sur) 이상
  • Apple Silicon (M1/M2/M3) 또는 Intel 칩
  • 최소 4GB RAM

Step 1: Docker Desktop 다운로드

1-1. 공식 사이트 접속

웹 브라우저를 열고 주소창에 입력하세요:

https://www.docker.com/products/docker-desktop

1-2. 다운로드 버튼 클릭

Windows 사용자:

  • “Download for Windows” 버튼을 클릭하세요.

Mac 사용자:

  • “Download for Mac” 버튼을 클릭하세요.
  • Apple Silicon (M1/M2/M3): “Apple Chip” 버전 선택
  • Intel Mac: “Intel Chip” 버전 선택

💡 Mac 칩 확인 방법: 화면 왼쪽 상단 사과 아이콘 → “이 Mac에 관하여” 클릭 → 칩 또는 프로세서 항목 확인

Step 2: Docker Desktop 설치

Windows 설치 방법

2-1. WSL2 활성화 (필수)

Docker Desktop은 WSL2(Windows Subsystem for Linux 2)가 필요합니다. PowerShell을 관리자 권한으로 실행하고 다음 명령어를 입력하세요:

wsl --install

실행하면 이런 메시지가 나옵니다:

설치 중: Linux용 Windows 하위 시스템
Linux용 Windows 하위 시스템이 설치되었습니다.

⚠️ 중요: 명령어 실행 후 컴퓨터를 재부팅해야 합니다.

2-2. Docker Desktop 설치 파일 실행

  1. 다운로드한 Docker Desktop Installer.exe 파일을 더블클릭합니다.
  2. “Use WSL 2 instead of Hyper-V” 옵션이 체크되어 있는지 확인합니다.
  3. “OK” 버튼을 클릭하고 설치가 완료될 때까지 기다립니다.
  4. 설치 완료 후 “Close and restart” 버튼을 클릭합니다.

2-3. Docker Desktop 실행

  1. 컴퓨터가 재시작되면 시작 메뉴에서 “Docker Desktop”을 검색합니다.
  2. Docker Desktop을 실행합니다.
  3. 서비스 약관(Docker Subscription Service Agreement)이 나타나면 “Accept”를 클릭합니다.

만약 “WSL 2 installation is incomplete” 오류가 나타나면, 위의 2-1 단계를 다시 확인하고 컴퓨터를 재부팅하세요.

Mac 설치 방법

2-1. DMG 파일 열기

다운로드한 Docker.dmg 파일을 더블클릭합니다.

2-2. Applications 폴더로 이동

열린 창에서 Docker 아이콘을 Applications 폴더로 드래그합니다.

(파일 크기가 크기 때문에 복사하는 데 1~2분 정도 걸릴 수 있습니다)

2-3. Docker Desktop 실행

  1. Launchpad 또는 Applications 폴더에서 Docker를 실행합니다.
  2. “Docker는 인터넷에서 다운로드한 앱입니다” 경고가 나타나면 “열기”를 클릭합니다.
  3. 시스템 권한을 요청하면 Mac 비밀번호를 입력합니다.
  4. 서비스 약관이 나타나면 “Accept”를 클릭합니다.

💡 팁: 상단 메뉴바에 고래 아이콘이 나타나면 Docker가 실행 중인 것입니다.

Step 3: 설치 확인

Docker가 제대로 설치되었는지 확인해봅시다.

3-1. 터미널(명령 프롬프트) 열기

Windows:

  • 시작 메뉴에서 “PowerShell” 또는 “명령 프롬프트”를 검색하여 실행

Mac:

  • Spotlight(Cmd + Space)에서 “터미널”을 검색하여 실행

3-2. Docker 버전 확인

다음 명령어를 입력하세요:

docker --version

실행하면 이런 결과가 나옵니다:

Docker version 27.4.0, build bde2b89

버전 숫자는 다를 수 있어요. 숫자가 출력되면 정상입니다!

3-3. Docker 상태 확인

다음 명령어로 더 자세한 정보를 확인할 수 있습니다:

docker info

“Server: Docker Desktop” 등의 정보가 출력되면 Docker가 정상적으로 실행 중입니다.

Step 4: 첫 번째 컨테이너 실행

이제 Docker가 제대로 동작하는지 테스트용 컨테이너를 실행해봅시다.

4-1. Hello World 컨테이너 실행

다음 명령어를 입력하세요:

docker run hello-world

처음 실행하면 이미지를 다운로드하는 메시지가 나옵니다:

Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
...
Status: Downloaded newer image for hello-world:latest

그 다음 이런 메시지가 출력됩니다:

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

🎉 축하합니다! Docker가 정상적으로 설치되었고, 첫 번째 컨테이너를 실행했습니다!

4-2. 웹 서버 컨테이너 실행해보기 (선택)

조금 더 실용적인 예제를 해볼까요? Nginx 웹 서버를 컨테이너로 실행해봅시다.

docker run -d -p 8080:80 nginx

💡 명령어 설명:

  • -d: 백그라운드에서 실행 (터미널을 계속 사용할 수 있음)
  • -p 8080:80: 내 컴퓨터의 8080 포트를 컨테이너의 80 포트와 연결

실행 후 웹 브라우저를 열고 주소창에 입력하세요:

http://localhost:8080

“Welcome to nginx!” 페이지가 보이면 성공입니다!

4-3. 실행 중인 컨테이너 확인

현재 실행 중인 컨테이너 목록을 확인해봅시다:

docker ps

실행 결과 예시:

CONTAINER ID   IMAGE   COMMAND                  STATUS          PORTS                  NAMES
a1b2c3d4e5f6   nginx   "/docker-entrypoint.…"   Up 2 minutes    0.0.0.0:8080->80/tcp   happy_einstein

4-4. 컨테이너 중지하기

테스트가 끝났으면 컨테이너를 중지합니다:

docker stop a1b2c3d4e5f6

a1b2c3d4e5f6 부분은 docker ps에서 확인한 CONTAINER ID를 입력하세요. 앞 3~4글자만 입력해도 됩니다.

자주 묻는 질문 (FAQ)

Q1. “WSL 2 installation is incomplete” 오류가 나타나요 (Windows)

해결 방법:

  1. PowerShell을 관리자 권한으로 실행
  2. wsl --install 명령어 실행
  3. 컴퓨터 재부팅
  4. Docker Desktop 다시 실행

Q2. Docker Desktop이 시작되지 않아요

해결 방법:

  1. 작업 관리자에서 Docker 관련 프로세스 모두 종료
  2. 컴퓨터 재부팅
  3. Docker Desktop 다시 실행

Q3. “permission denied” 오류가 나타나요 (Mac/Linux)

해결 방법: 명령어 앞에 sudo를 붙여서 실행해보세요:

sudo docker run hello-world

Q4. 이미지 다운로드가 너무 느려요

Docker Hub 서버 상태나 네트워크 환경에 따라 다를 수 있습니다. 잠시 기다리거나, 네트워크 연결을 확인해보세요.

마무리

축하합니다! 이제 여러분의 컴퓨터에서 Docker를 사용할 수 있습니다.

오늘 배운 것

  • ✅ Docker Desktop 설치 (Windows / Mac)
  • ✅ WSL2 활성화 (Windows)
  • ✅ Docker 설치 확인
  • ✅ 첫 번째 컨테이너 실행 (hello-world)
  • ✅ 웹 서버 컨테이너 실행 (nginx)

다음에 배울 것

  • Docker 이미지 만들기 (Dockerfile)
  • Docker Compose로 여러 컨테이너 관리하기
  • Docker Hub에서 이미지 검색하고 사용하기

유용한 Docker 명령어 모음

명령어 설명
docker ps 실행 중인 컨테이너 목록
docker ps -a 모든 컨테이너 목록 (중지된 것 포함)
docker images 다운로드한 이미지 목록
docker stop [ID] 컨테이너 중지
docker rm [ID] 컨테이너 삭제
docker rmi [이미지명] 이미지 삭제
이해가 쌓이는 곳, 콰이어트 노트

궁금한 점이나 더 나은 설명이 있다면 알려주세요.

의견 보내기

KEEP EXPLORING