Docker Desktopが起動しない!原因と対処法7選【Windows版】

Docker

Docker Desktopを立ち上げたのに「Starting…」から先に進まない、アイコンをクリックしても画面が表示されない──。
こうしたトラブルはDockerを使う開発者なら一度は経験することだ。
この記事では、Docker Desktopが起動しない主な原因を整理したうえで、試すべき対処法を優先順位の高い順に7つ解説する。


スポンサーリンク

Docker Desktopが起動しない主な原因

Docker Desktopが起動しない原因は、大きく以下の3種類に分類できる。

  1. プロセスが残留している:前回の強制終了などでDockerのプロセスがバックグラウンドに残り、新規起動を阻害しているケース。最も報告数が多い。
  2. WSL2の設定不備・バージョン不一致:Windows版のDocker DesktopはWSL2(Windows Subsystem for Linux 2)をバックエンドとして使用している。WSL2の不具合やバージョン不一致が起動を妨げることがある。
  3. 設定ファイルの破損:AppDataフォルダ内の設定ファイルが破損して起動に失敗するケース。

これらを踏まえ、以下の順番で試してほしい。


対処法1:Dockerプロセスをタスクマネージャーで強制終了する【最優先】

最初に試すべき対処法だ。
データを失わずに解決できる可能性が高く、成功率も高い。

操作手順は以下のとおりだ。

  1. タスクバーを右クリック→「タスクマネージャー」を開く
  2. 「プロセス」タブで以下のプロセスを探す
  • Docker Desktop
  • com.docker.backend
  • com.docker.build
  • dockerd
  1. 見つかったプロセスをすべて右クリック→「タスクの終了」をクリック
  2. すべて終了したら、改めてDocker Desktopを起動する

対処法2:PCを再起動する

プロセス終了で解決しない場合は、PCそのものを再起動しよう。
残留プロセスやメモリの一時的な問題をリセットできることが多い。

再起動後はDocker Desktopを管理者として実行すると、権限不足による起動失敗を回避できる場合がある(Docker Desktop.exeを右クリック→「管理者として実行」)。


対処法3:Docker Desktopをアップデートする

しばらく使っていなかったDocker Desktopを久しぶりに起動すると「Starting the Docker Engine…」から進まないケースが報告されている。
この原因のひとつとして、古いバージョンが最新のWSL2や Windowsと互換性を失っていることがある。

とくに、WSL2が2.5.7以降にアップデートされると、Docker Desktop 4.41以前では起動しなくなるという問題がDockerの公式GitHubで報告されている(docker/for-win issue #14804)。
この場合はDocker Desktopを最新版(4.42以降)にアップデートすることで解決する。

Docker Desktopのアップデートは、タスクトレイのDockerアイコンを右クリック→「Check for Updates」から確認できる。


対処法4:WSL2をアップデートする

Docker DesktopはWSL2をバックエンドとして使用しているため、WSL2側に問題があると起動に失敗することがある。

PowerShellを管理者で起動し、以下のコマンドを実行してWSL2を最新版に更新しよう。

wsl --update

更新後、以下のコマンドでWSL2が正常に動作しているか確認する。

wsl --status

Default Version: 2と表示されていれば問題ない。
表示されない場合は以下のコマンドでデフォルトバージョンを設定する。

wsl --set-default-version 2

WSL2とVS CodeのDocker連携については、VS CodeでWSL2に接続する方法も参考にしてほしい。


対処法5:Windowsの仮想化機能を確認する

Docker DesktopはWindowsの仮想化機能を必要とする。
Windows Updateなどをきっかけに仮想化機能が無効化されることがあり、これが原因で起動しなくなるケースが報告されている。

確認・有効化の手順は以下のとおりだ。

  1. Windowsキーを押して「Windowsの機能の有効化または無効化」を検索して開く
  2. 以下の2項目にチェックが入っているか確認する
  • 「Linux用Windowsサブシステム」
  • 「仮想マシン プラットフォーム」
  1. チェックが外れていた場合はチェックを入れてPCを再起動する

対処法6:設定ファイル(Roamingフォルダ)を削除する

「Docker failed to initialize」のエラーが出たり、設定ファイルが破損している可能性がある場合はこの方法を試す。

以下のフォルダを削除してから、Docker Desktopを再起動する。

C:\Users\[ユーザー名]\AppData\Roaming\Docker

注意:AppDataは隠しフォルダのため、エクスプローラーの「表示」→「隠しファイル」を有効にしてからアクセスする。

このフォルダにはDockerの設定情報が保存されているが、削除してもイメージやコンテナデータは消えないので安心して試してほしい。


対処法7:Docker Desktopを初期化する(Reset to factory defaults)

上記の対処法を試しても改善しない場合の最終手段だ。
Docker Desktopの設定をすべてリセットすることで、破損した設定を完全に解消できる。

ただし、すべてのイメージ・コンテナ・ボリュームが削除される。
実行前に必ず重要なイメージをエクスポートしておくこと。

# 重要なイメージのバックアップ
docker save -o backup.tar イメージ名

バックアップが取れたら、以下の手順で初期化する。

  1. Docker Desktopのウィンドウ右上にある「バグ(虫)アイコン」をクリック
  2. 「Troubleshoot」を選択
  3. 「Reset to factory defaults」をクリック

初期化後は必要に応じてWSL2の設定も再確認しよう(対処法4・5参照)。


エラーメッセージ別:よくある症状と原因

症状・エラーメッセージ主な原因試すべき対処法
Starting...から進まないプロセス残留 / WSL2問題対処法1→4の順
WSL 2 installation is incompleteWSL2が未インストール / バージョン不一致対処法4
Docker failed to initialize設定ファイル破損対処法6
Engine stopped / context deadline exceededDocker Desktopと WSL2のバージョン不一致対処法3
仮想化エラー仮想化機能が無効対処法5

まとめ

Docker Desktopが起動しない場合は、まずタスクマネージャーでDockerプロセスを全終了してから再起動を試してほしい。
それで解決しない場合は、WSL2のアップデート・Docker Desktop本体のアップデート・Windowsの仮想化機能確認の順に試していくのが効率的だ。
設定ファイルの破損が疑われる場合はRoamingフォルダの削除、最終手段として「Reset to factory defaults」を実行しよう。


参考情報源:

コメント

タイトルとURLをコピーしました