Debian에 Docker Desktop 설치하기

이 페이지는 Debian 배포판에 Docker Desktop을 설치하고, 실행하고, 업그레이드하는 방법을 설명해요.

출처: Install Docker Desktop on Debian

본문

Docker Desktop 약관: 더 큰 기업(직원 250명 초과 또는 연간 매출 1천만 달러 초과)에서 Docker Desktop을 상업적으로 사용하려면 유료 구독이 필요해요.

사전 요구 사항

Docker Desktop을 성공적으로 설치하려면:

일반 시스템 요구 사항을 충족.
64비트 버전의 Debian 12.
Gnome 데스크톱 환경이라면 AppIndicator 및 KStatusNotifierItem Gnome 확장도 설치.
GNOME을 사용하지 않는다면 gnome-terminal을 설치해서 터미널 접근을 활성화:

$ sudo apt install gnome-terminal

Docker Desktop 설치하기

Docker의 apt 리포지토리를 설정해요. apt 리포지토리로 설치하기의 1단계 참고.
최신 DEB 패키지를 다운로드해요. 체크섬은 릴리스 노트 참고.
apt로 패키지를 설치해요.

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

참고: 설치 과정이 끝날 때 다운로드한 패키지 설치 때문에 apt가 오류를 표시해요. 이 오류 메시지는 무시해도 돼요.

N: Download is performed unsandboxed as root, as file '/home/user/Downloads/docker-desktop.deb' couldn't be accessed by user '_apt'. - pkgAcquire::Run (13: Permission denied)

기본적으로 Docker Desktop은 /opt/docker-desktop에 설치돼요.

DEB 패키지는 추가 설정 단계를 자동으로 완료하는 post-install 스크립트를 포함해요. 이 스크립트는:

Docker Desktop 바이너리에 privileged 포트 매핑과 리소스 제한 설정 capability를 설정해요.
Kubernetes용 DNS 이름을 /etc/hosts에 추가해요.
/usr/local/bin/com.docker.cli에서 /usr/bin/docker로의 심볼릭 링크를 만들어요. 클래식 Docker CLI가 /usr/bin/docker에 설치되기 때문이에요. 래퍼는 클래식 Docker CLI에 접근할 수 있게 됩니다.

Docker Desktop 실행하기

Gnome/KDE 데스크톱에서 Docker Desktop 애플리케이션으로 이동해요.
Docker Desktop을 선택해 Docker를 시작해요. Docker Subscription Service Agreement가 표시돼요.
Accept 를 선택해 계속 진행해요. 약관에 동의하면 Docker Desktop이 시작돼요. 약관에 동의하지 않으면 실행되지 않아요.

대안으로 터미널을 열고 실행해요.

$ systemctl --user start docker-desktop

Docker Desktop이 시작되면 전용 컨텍스트를 만들고 현재 컨텍스트로 설정해요. 이는 default 컨텍스트를 사용하는 로컬 Docker Engine과의 충돌을 피하기 위해서예요. 종료 시 이전 컨텍스트로 리셋해요. 설치 프로그램은 Docker Compose와 Docker CLI 바이너리를 업데이트하고, 새 Docker CLI 바이너리를 /usr/local/bin/com.docker.cli에 설치하며 /usr/local/bin에서 클래식 CLI로의 심볼릭 링크를 만들어요.

설치 후 바이너리 버전을 확인할 수 있어요.

$ docker compose version
Docker Compose version v2.39.4

$ docker --version
Docker version 28.4.0, build d8eb465

Debian에 Docker Desktop 설치하기