Ubuntu에 Docker Desktop 설치하기

Ubuntu에 Docker Desktop 설치하기

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

출처: Install Docker Desktop on Ubuntu

본문

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

사전 요구 사항

Docker Desktop을 성공적으로 설치하려면 다음을 해야 해요.

  • 일반 시스템 요구 사항을 충족.
  • Ubuntu 26.04 LTS 또는 24.04 LTS가 있는 x86-64 시스템.
  • GNOME 데스크톱 환경이라면 AppIndicator 및 KStatusNotifierItem GNOME 확장을 설치.
  • GNOME을 사용하지 않는다면 gnome-terminal을 설치해서 Docker Desktop에서 터미널 접근을 활성화:
$ sudo apt install gnome-terminal

Docker Desktop 설치하기

Ubuntu에 Docker Desktop을 설치하는 권장 방법:

  • Docker의 패키지 리포지토리를 설정해요. apt 리포지토리로 설치하기의 1단계를 참고하세요.
  • 최신 DEB 패키지를 다운로드해요. 체크섬은 릴리스 노트 참고.
  • apt로 패키지를 설치해요.
$ sudo apt-get update
$ sudo apt 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 Desktop 설치 프로그램은 클라우드 통합 기능을 포함하고 본질적으로 Compose CLI의 래퍼인 Docker CLI 바이너리도 /usr/local/bin/com.docker.cli에 설치해요. 이 심볼릭 링크는 래퍼가 클래식 Docker CLI에 접근할 수 있게 해줘요.

Docker Desktop 실행하기

Linux용 Docker Desktop을 시작하려면:

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

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

$ systemctl --user start docker-desktop

Docker Desktop이 시작되면 Docker CLI가 대상으로 사용할 수 있는 전용 컨텍스트를 만들고 현재 사용 중인 컨텍스트로 설정해요. 이는 default 컨텍스트를 사용하는 로컬 Docker Engine과의 충돌을 피하기 위해서예요. 종료 시 Docker Desktop은 현재 컨텍스트를 이전 것으로 리셋해요.

설치 프로그램은 Docker Compose와 Docker CLI 바이너리를 업데이트해요. Docker Compose V2를 설치하고 Settings 패널에서 docker-compose로 링크할지 선택할 수 있게 해줘요. 새 Docker CLI 바이너리를 /usr/local/bin/com.docker.cli에 설치하고 /usr/local/bin에서 클래식 Docker CLI로의 심볼릭 링크를 만들어요.

설치 후 다음 명령으로 바이너리 버전을 확인할 수 있어요.

$ docker compose version
Docker Compose version v2.39.4

$ docker --version
Docker version 28.4.0, build d8eb465

$ docker version
Client:
 Version:           28.4.0
 API version:       1.51
 Go version:        go1.24.7

더 알아보기