Docker Desktop에서 새 버전 알림이 떴는데 Download update 버튼을 눌러도 아무 반응이 없을 때가 있다.
버튼을 여러 번 눌러 보고, Docker Desktop을 껐다 켜고, 그래도 안 되면 “Docker가 고장난 것 같다”고 생각하기 쉽다.
하지만 먼저 구분해야 한다.
Docker Desktop GUI
Docker Updater
Docker Engine세 가지는 같은 문제가 아닐 수 있다.
1. 먼저 현재 Docker Engine이 정상인지 본다
업데이트 버튼이 동작하지 않아도 현재 Docker Engine은 정상일 수 있다.
PowerShell:
docker version
docker ps이 명령이 정상적으로 동작하고 container도 보인다면 최소한 현재 runtime은 살아 있다.
즉 문제 범위를:
Docker 전체 장애에서:
Updater / Desktop UI 문제로 줄일 수 있다.
2. 버전과 Background Download 상태를 확인한다
업데이트 알림의 현재 버전과 최신 버전을 다시 확인한다.
다음도 같이 본다.
Settings → Software updates
About
Release notes가끔 버전 숫자가 비슷해서 잘못 읽거나, 업데이트 notification이 오래된 상태로 남아 있을 수 있다.
내려받다 멈춘 경우
Docker Desktop은 설정에 따라 update를 background에서 다운로드할 수 있다.
따라서 버튼이 반응하지 않는다고 다운로드가 전혀 시작되지 않은 것은 아닐 수 있다.
확인할 것:
Automatically check for updates
Always download updates
Desktop restart 필요 여부
Updater process 상태3. Desktop 프로세스와 Engine을 구분해 재시작한다
전체 환경을 초기화하기 전에 Desktop application만 재시작해 본다.
여기서 중요한 점은 “문제가 updater인데 container data까지 건드리지 않는 것”이다.
처음부터:
Reset to factory defaults
Delete data
Uninstall로 가는 것은 과도하다.
4. GUI가 안 되면 Docker Desktop CLI를 먼저 확인한다
Docker Desktop 4.37 이상이면 업데이트를 확인하고 적용하는 CLI 명령이 있다. 4.36 이하에는 이 명령이 없으므로, 없다고 나오면 버전부터 확인한다.
docker desktop update --check-only
docker desktop updateGUI 버튼이 반응하지 않을 때는 installer를 바로 다시 실행하기 전에 이 경로를 먼저 확인하는 편이 깔끔하다.
CLI 업데이트도 사용할 수 없거나 실패한다면 그 다음에 공식 installer를 이용한 업데이트를 검토한다.
다만 실행 전에 다음을 확인한다.
중요 container가 실행 중인가
local volume에 중요한 데이터가 있는가
회사 정책상 설치 권한이 있는가
rollback이 필요한 환경인가5. Factory Reset 전에 Volume부터 확인한다
Container 자체는 재생성할 수 있지만 데이터는 그렇지 않을 수 있다.
업데이트 전 다음을 확인하는 습관이 좋다.
docker ps -a
docker volume ls
docker images중요한 bind mount나 named volume이 무엇인지 알고 있어야 한다.
Factory Reset은 마지막 수단
Docker Desktop 문제를 검색하면 factory reset을 권하는 답변이 자주 나온다.
하지만 reset은 영향을 크게 줄 수 있다.
따라서 순서는 보통 다음이 안전하다.
Version 확인
↓
Engine 정상 여부 확인
↓
Desktop restart
↓
Updater 상태 확인
↓
docker desktop update --check-only
↓
Docker Desktop CLI update
↓
필요 시 공식 installer update
↓
문제가 계속될 때 추가 진단
↓
Factory reset은 마지막6. 회사 PC라면 정책 문제도 본다
기업 환경에서는 GUI 버튼 문제처럼 보여도 실제 원인은 다음일 수 있다.
Proxy
Endpoint Security
Application Control
권한 제한
Installer 차단
네트워크 정책개인 PC와 동일하게 판단하면 안 된다.
직접 실행하는 진단 점검 순서
[ ] docker version 정상
[ ] docker ps 정상
[ ] 현재/최신 버전 확인
[ ] background update 설정 확인
[ ] Desktop restart
[ ] docker desktop update --check-only 확인
[ ] 중요 volume 확인
[ ] 필요 시 공식 installer 사용 가능 여부 확인
[ ] factory reset은 마지막이 순서가 통하지 않는 경우
업데이트 버튼이 안 눌린다고 Docker Engine까지 고장난 것은 아닙니다. GUI·Updater·Engine·Data를 나눠 보면 대개 reset 없이 끝납니다. 다만 이 순서가 답을 주지 못하는 경우가 있습니다.
-
docker desktop update가 없는 버전. 4.37 미만에는 이 명령 자체가 없습니다. 위 4번이 통째로 건너뛰어집니다. -
설치 권한이 없는 회사 PC. 1~6단계를 다 해도 결론이 “관리자에게 요청”으로 끝납니다. 그 경우 진단의 목적은 해결이 아니라 무엇을 요청할지 특정하는 것입니다.
-
WSL2 백엔드가 깨진 경우. 이 글의 GUI/Updater/Engine 분리에는 그 계층이 없습니다.
docker version이 서버 쪽에서 실패하면wsl --update와wsl --status를 먼저 봐야 하고, 그건 Docker Desktop 문제가 아닙니다. -
업데이트가 실제로 배포되지 않은 상태.
--check-only가 최신이라고 답하면 버튼이 안 눌리는 게 아니라 누를 것이 없는 것입니다.