こんにちは、フルスタックエンジニアのryuです。
今回の記事では、Docker Desktopが起動しない場合の対処方法について解説します。
私も以前、Docker Desktopが起動しなくなり、Restartボタンも押せない状態になったことがありました。そのときは、WindowsのタスクマネージャーからDocker Desktop関連のプロセスを終了し、もう一度起動することで正常に動作するようになりました。
ただし、Docker Desktopが起動しない原因は一つではありません。
プロセスが残っている、WSL 2が正常に動いていない、Docker Desktopの設定やデータに問題があるなど、いくつかの原因が考えられます。
そのため、いきなり初期化するのではなく、データが消えない対処方法から順番に試すことが大切です。
Docker Desktopが起動しない場合の対処方法とは？¶
今回の記事では、Docker Desktopが起動しない場合の対処方法について解説します。
まずは、次の順番で確認するのがおすすめです。
| 順番 | 対処方法 | データへの影響 |
|---|---|---|
| 1 | Docker Desktop関連プロセスを終了して再起動 | 基本的になし |
| 2 | Windowsを再起動 | 基本的になし |
| 3 | WSL 2を再起動・更新 | 基本的になし |
| 4 | Troubleshootやログを確認 | なし |
| 5 | Reset to factory defaults | データ消失に注意 |
特に、Reset to factory defaultsを最初に実行しないことが重要です。
Dockerイメージやボリュームなど、大切な開発データがある場合はバックアップしてから実行しましょう。
Docker Desktopのプロセスを消してから起動する¶
まず、私が実際に復旧できた方法です。
Docker Desktopを終了したつもりでもバックグラウンドプロセスが残っていると、もう一度起動してもうまく立ち上がらないことがあります。
タスクマネージャーでDocker Desktopのプロセスを消す¶
Docker Desktopのプロセスを終了するためには、タスクマネージャーを開きます。スタートメニューから「タスクマネージャー」と検索しましょう。
Docker Desktopのバージョンによって表示名は異なりますが、Docker DesktopやDocker Desktop Backendなど、Docker関連のプロセスを確認します。
対象のプロセスを確認したら、右クリックして「タスクの終了」をクリックします。
作業中のコンテナがある場合は停止する可能性があるため、実行中の処理がないことを確認してから終了してください。
プロセスを終了後もう一度Docker Desktopを起動する¶
プロセスを終了したら、もう一度Docker Desktopを起動します。
スタートメニューからDocker Desktopを検索して起動します。
起動後は、PowerShellやターミナルから次のコマンドで確認できます。
docker version
docker info
Server側の情報まで表示されれば、Docker Engineへ接続できています。
WSL 2を再起動・更新する¶
WindowsでDocker Desktopを利用している場合、WSL 2側の状態が原因で起動できないこともあります。
まずPowerShellでWSLのバージョンを確認します。
wsl --version
Docker公式では、WSL 2.1.5以上が必要で、できるだけ最新のWSLを利用することが推奨されています。
更新する場合は次のコマンドです。
wsl --update
WSL自体が固まっているような場合は、作業中の処理がないことを確認してから一度終了します。
wsl --shutdown
その後、Docker Desktopをもう一度起動してみてください。
Docker DesktopのTroubleshootを確認する¶
Docker Desktopの画面を開ける場合は、Troubleshootメニューも利用できます。
現在のDocker Desktopでは、TroubleshootからRestart、診断、データ削除、初期化などを行えます。
まずはRestartや診断から試し、いきなり初期化しないのがおすすめです。
Docker Desktop CLIが利用できる環境では、次のようなコマンドもあります。
docker desktop status
docker desktop restart
診断機能を利用できるバージョンでは、次のコマンドで診断できます。
docker desktop diagnose
起動しない原因が分からない場合は、推測だけで設定を削除するより、Troubleshootやログを確認して原因を絞り込みましょう。
Docker Desktopを初期化する¶
ここまで試しても復旧しない場合は、Docker Desktopを初期化する方法があります。
Docker Desktopを初期化する方法¶
Troubleshoot画面からReset to factory defaultsを選択します。
Reset to factory defaultsを実行すると、Docker Desktopの設定を初期状態へ戻します。
Docker Desktopを初期化する場合の注意点¶
Docker Desktopを初期化すると、設定やローカルのDockerデータを失う可能性があります。
重要なDockerイメージはDocker HubやAWSのECRなどへ保存しておきましょう。
DockerイメージをDockerHubにpushしてみよう！【Docker入門⑤】
【AWS】ECRの使い方とは？DockerイメージをECRにpushする方法解説！
イメージをローカルファイルへ保存する方法もあります。
docker image save -o my-image.tar my-image:latest
復元する場合は次の通りです。
docker image load -i my-image.tar
ただし、Docker Volumeに保存したデータはイメージとは別物です。
データベースなどをVolumeへ保存している場合は、イメージをバックアップしただけでは復旧できないため、必要なデータを別途バックアップしてください。
“Docker failed to initialize”というエラーで起動しない場合¶
Docker failed to initializeというエラーが表示される場合については、別の記事で詳しく解説しています。
【関連記事】“Docker failed to initialize”というエラーが出た場合の対処方法
以前はC:\Users\[ユーザー]\AppData\Roaming\Dockerを削除する方法も紹介していましたが、設定ファイルを直接削除する方法は影響が大きいため、現在はまず公式のTroubleshootや診断機能を利用するのがおすすめです。
Docker Desktopが起動しない場合の確認順¶
最後に、実際に試す順番をまとめます。
- Docker Desktop関連のプロセスを終了する
- Docker Desktopをもう一度起動する
- Windowsを再起動する
wsl --updateやwsl --shutdownでWSL 2を確認する- Troubleshootや診断ログを見る
- 必要なDockerデータをバックアップする
- 最後にReset to factory defaultsを検討する
この順番であれば、いきなりDockerのデータを消してしまうリスクを減らせます。
Dockerを仕組みから学習する¶
Docker Desktopのトラブルでは、DockerだけではなくLinux、WSL、仮想化、ネットワークなどの知識も関係します。
エラーが出るたびに解決コマンドだけを覚えるより、Dockerがどのような仕組みで動いているのか理解しておくと原因を切り分けやすくなります。
InfraAcademyでは、LinuxやDocker、ネットワーク、AWSなどインフラの基礎を実際に操作しながら学習できます。
Linuxを基礎から学びたい方は、Linux入門講座をご覧ください。
AWS上でDockerイメージやサーバーを扱いたい方は、AWS講座も利用できます。
Docker Desktopが起動しない場合の対処方法まとめ¶
今回の記事では、Docker Desktopが起動しない場合の対処方法について解説しました。
私の場合は、Docker Desktop関連のプロセスをタスクマネージャーから終了し、もう一度起動することで復旧しました。
ただし、同じ症状でも原因は異なります。
現在のDocker Desktopでは、TroubleshootからRestartや診断、Reset to factory defaultsなどを利用できます。
Docker Desktopのトラブルシューティング公式ドキュメント
いきなり初期化するのではなく、データを消さない方法から一つずつ原因を切り分けることが大切です。
当ブログでは、インフラに関する技術を発信しているので興味のある方は是非ご覧ください。
さらにDockerを勉強したい方は、こちらの動画や参考書がオススメです。
