Windows のターミナルでは docker を実行できるのに、Ubuntu で command not found と表示される場合、そのディストリビューションで Docker Desktop の WSL 統合が有効になっていない可能性があります。コマンドが存在して Cannot connect to the Docker daemon が出る場合は、Docker Desktop の起動状態、現在の Docker context、DOCKER_HOST を確認します。最初に読み取り専用コマンドで障害箇所を特定し、Docker データのリセットや WSL ディストリビューションの登録解除から始めないでください。
この記事は、Windows 上の Docker Desktop、WSL 2 Linux ディストリビューション、Linux コンテナーの作業環境を対象にしています。Docker Desktop の WSL 2 backend、Docker VMM、Hyper-V は挙動が異なるため、使用中の方式を確認してください。Windows コンテナー mode は、ここで扱う Linux コンテナー環境とは別です。
Windows、WSL、Docker Engine のどこで失敗しているか確認する
まず Windows PowerShell で基本状態を確認します。
|
|
これらのコマンドはコンテナーやディストリビューションを変更しません。wsl --list --verbose では各ディストリビューションが WSL 1 と WSL 2 のどちらかを確認できます。docker version は Client と Server に分かれています。Client だけが表示される場合、Docker CLI は見つかっていますが Engine に接続できていません。
続いて、開発に使う Linux ディストリビューションを開き、そこで確認します。
|
|
両方の結果を見比べることで、「Windows がプログラムを見つけられない」「ディストリビューションに CLI が追加されていない」「Engine が応答しない」を区別できます。
WSL 自体が正常に動作するか確認する
wsl --status、wsl -l -v、または Ubuntu の起動自体が失敗する場合は、先に WSL と Windows の仮想化機能を調べます。Docker Desktop の設定はまだ変更しません。
Docker の現在の要件では、Docker Desktop の WSL 2 backend に必要な最低 WSL version は 2.1.5 です。WSL を最新に保つことも推奨されています。次のコマンドで確認します。
|
|
WSL が古い場合は、編集中のファイルを保存してから更新し、WSL 仮想マシンを再起動します。
|
|
wsl --shutdown は実行中のすべての WSL ディストリビューションを直ちに停止します。Ubuntu を開き直し、wsl -l -v の VERSION 列で対象が 2 になっていることを確認します。1 の場合、重要なファイルをバックアップせずに変換しないでください。変換には時間がかかり、失敗することもあります。
WSL の更新が失敗したら、Microsoft Store、Windows Update、ネットワークポリシーを確認します。wsl --update --web-download では Web からダウンロードできます。更新中に Windows を強制終了したり、wsl --unregister を通常の再起動コマンドとして使ったりしないでください。
Docker Desktop が起動し、Linux コンテナー mode になっているか確認する
Windows のタスクバーで Docker Desktop の起動完了を確認します。状態が Starting または Docker Engine is starting のまま、あるいは Engine エラーが表示される場合は、全文を記録します。通知領域のメニューに「Switch to Linux containers」があれば、Windows コンテナー mode の可能性があります。WSL の Linux コンテナー開発には Linux コンテナー mode が必要です。
WSL 統合の項目が表示されるのは、対応する backend とコンテナー mode の場合だけです。Docker Desktop が WSL 2 engine を使っている場合、Settings > General で「Use the WSL 2 based engine」を確認します。次に Settings > Resources > WSL Integration で必要なディストリビューションを有効にし、Apply を選びます。
複数のディストリビューションがある場合、既定のものと現在開いているものが異なることがあります。wsl -l -v で正確な名前を確認し、統合画面で対象を有効にします。既定のディストリビューションを変更するには、次を実行します。
|
|
Ubuntu は一覧に表示される正確な名前に置き換えます。既定値の変更は、ディストリビューション名を指定しない WSL コマンドに影響します。他のディストリビューションを WSL 2 に変換したり、ファイルを移動したりする操作ではありません。
WSL で docker コマンドが見つからない
Windows PowerShell では docker version が動くのに、Linux ディストリビューションで command not found が出る場合は、次の順に確認します。
wsl -l -vで対象の version が 2 か確認します。- Docker Desktop の設定で WSL 2 engine を有効にします。
- Settings > Resources > WSL Integration で現在のディストリビューションを有効にします。
- Apply を選び、Docker Desktop の適用完了を待ちます。
- Windows で
wsl --shutdownを実行し、ディストリビューションを開き直します。 - ディストリビューションで
command -v dockerとdocker versionを実行します。
コマンドが見つからないからといって、ディストリビューション内に別の Docker Engine をすぐインストールしないでください。Docker は、WSL ディストリビューションへ Docker Engine や CLI を直接インストールすると、Docker Desktop の統合と競合する可能性があると説明しています。二重インストールにより CLI が別の daemon を使い、Ubuntu と Windows でコンテナー一覧が異なることもあります。
Linux ディストリビューション内で独立した Engine を動かすのは別の構成です。daemon、データディレクトリ、起動サービス、Docker context の管理者を明確にしてください。同じ開発コマンドで二つの Engine が競合しないようにします。
コマンドはあるが Docker daemon に接続できない
Windows で Docker Desktop が完全に起動したことを確認してから実行します。
|
|
現在の context が SSH のリモートホストなどを指している場合、docker はローカル Desktop ではなく別の endpoint に接続している可能性があります。確認してから Desktop 用 context に切り替えます。リモート context は意図的に設定されている場合もあるため、設定全体を無条件に上書きしないでください。
WSL では、環境変数が接続先を上書きしていないか確認します。
|
|
DOCKER_HOST は CLI の接続先 socket または TCP address を固定できます。DOCKER_CONTEXT は別の context を選ぶことがあります。値と設定元を記録してから、現在のターミナルで一時的に削除するか判断します。PowerShell では次を確認できます。
|
|
sudo docker を汎用的な接続修復方法として使わないでください。root ユーザーの Docker 設定や context が使われ、別の daemon へ接続する可能性があります。権限エラーでは、どの Docker CLI と Engine が関係しているかを先に確認します。
Docker Desktop Engine がまだ起動中なら、Compose コマンドを再試行しても同じ失敗が繰り返されます。Dashboard で Engine の準備完了を確認し、docker version に Server 情報が出てからプロジェクトのコマンドを実行します。
接続できるが、想定と異なるコンテナーが表示される
CLI が別の Engine に接続している可能性があります。context と実行ファイルの解決先を確認します。
|
|
WSL では次を実行します。
|
|
type -a docker に複数のパスが表示されたら、最初の実行ファイルがどこから来たか確認します。Windows PATH 経由で使える Docker Desktop CLI、ディストリビューション内にインストールされた CLI、shell alias が共存していることがあります。ファイルを消したりシステム PATH を変更したりする前に、由来を特定します。
コンテナー、イメージ、volume はそれぞれの Engine に属します。context を変えた後、docker ps -a や docker volume ls の結果が違うのは正常です。削除前に接続先を確認し、リモートの本番環境をローカルのテスト用 Engine と間違えないでください。
WSL エラーまたは仮想マシンの起動失敗が表示される
エラーに HCS_E_HYPERV_NOT_INSTALLED や ERROR_NOT_SUPPORTED が含まれる場合、または WSL でもディストリビューションを起動できない場合は、Windows 機能とハードウェア仮想化を先に確認します。
- BIOS/UEFI で CPU 仮想化が有効か。
- Windows で Virtual Machine Platform と Windows Subsystem for Linux が有効か。
- Windows を仮想マシンまたはクラウドデスクトップ内で実行している場合、ホストで nested virtualization が有効か。
- 起動設定や他の仮想化ソフトウェアで hypervisor が無効になっていないか。
- 最近 Android emulator や古い VM 製品を入れ、Hyper-V 設定が変わっていないか。
タスクマネージャーの Performance > CPU で仮想化状態を確認できます。現在の VM 構成を理解せずに BCD や Windows 機能を変更しないでください。管理対象 PC では組織のポリシーも確認します。
wsl -l -v は正常だが、Docker Desktop の docker-desktop だけが異常な場合は、エラー全文と時刻を保存し、Docker Desktop の Troubleshoot > Get support から診断を収集します。docker-desktop や docker-desktop-data を手動で削除したり、その中でクリーンアップコマンドを実行したりしないでください。
WSL 統合メニューがない、または選択したディストリビューションが動かない
Docker Desktop が Windows コンテナー mode でないことを確認し、backend を特定します。Docker のドキュメントによると、完全な WSL Integration は WSL 2 engine でのみ利用できます。Docker VMM では最近の version から WSL ディストリビューション内で Docker CLI を使えますが、socket、直接マウント、開発ツールの対応範囲は異なります。
backend を変更する前に、使用中の Docker Desktop version の設定資料を読み、開発ツールが必要とする機能を確認します。docker が実行できても、Docker Engine API socket を使う VS Code Dev Containers、Docker SDK、Testcontainers との互換性までは保証されません。
統合を有効にした直後で、ターミナルに古い環境が残っている場合は次を実行します。
|
|
その後、対象のディストリビューションを開き直します。これはすべてのディストリビューションと WSL 仮想マシンを停止します。ファイルはリセットしませんが、保存していないプロセス状態は失われます。
統合を更新するためだけに WSL 1/2 を何度も切り替えたり、ディストリビューションの登録を解除したり、Docker Desktop を factory reset したり、仮想ディスクを削除したりしないでください。データを失う可能性があり、初期調査では通常不要です。
Docker VMM でコマンドは動くが、マウントや開発ツールが動かない
Docker VMM と WSL 2 engine は異なる方法で連携します。VMM mode では WSL から Windows interop 経由で Docker CLI を呼べます。一方、現在のドキュメントには、Linux Docker socket がないこと、Windows drive 上のファイルのみ直接 bind mount できることが制限として記載されています。socket に依存する Docker SDK、Testcontainers、Dev Containers は動かない場合があります。
PowerShell から起動したプロジェクトは通常 C:\... のパスを使います。同じ Windows drive は WSL で /mnt/c/... として見えます。Docker VMM 使用時に /home/... のようなディストリビューション内のパスでエラーが出たら、その workflow が対応しているか確認します。Linux パスを Windows パスに変えるだけで、権限、file watching、性能も同じになるとは限りません。
WSL 2 engine で Linux 開発をする場合、Docker はファイルシステムをまたぐ処理を減らすため、プロジェクトを Linux ディストリビューション内に置くことを推奨しています。Windows ツールと Linux コンテナーの両方から同じプロジェクトに頻繁にアクセスする場合は、権限、大小文字の扱い、file watching、mount 性能を評価して、主な作業場所を決めます。
マウントに失敗したら、source path の存在、コマンドの実行ディレクトリ、backend、対象ディストリビューションの統合状態を確認します。コンテナーパス /app、Windows パス C:\project、WSL パス /mnt/c/project を混同しないでください。
WSL にディストリビューションがあるのに Docker Desktop が見つけられない
Windows で一覧をもう一度出し、version 列を確認します。
|
|
ディストリビューション名に空白や大文字小文字の違いがある場合は、コマンド出力と同じ名前を選びます。新しいディストリビューションは WSL 1 でインストールされる場合がありますが、Docker Desktop の WSL 2 統合には WSL 2 が必要です。変換前にバックアップします。
|
|
export にはディストリビューションのデータが含まれ、大きなディスク容量を使うことがあります。変換前にバックアップが作成され、アクセスできることを確認します。重要なディストリビューションの名前が違う場合、例の名前をそのまま使わないでください。
ディストリビューションを改名、移動、import したことがある場合、wsl -l -v で登録名と状態を確認します。「再表示」させるために登録情報を削除しないでください。登録情報、ディスクファイル、Docker Desktop が管理する仮想ディスクは別のものです。
Docker Desktop 更新後に統合が突然動かなくなった
更新後すぐにイメージやコンテナーをすべて削除しないでください。Docker Desktop version、wsl --version、ディストリビューション名、backend、完全なエラーを記録し、Docker の release notes に同じ version の組み合わせがないか確認します。
Docker の最近の release notes には、WSL 2.6.x 以降でユーザーディストリビューションとの統合が失敗し、0 byte の proxy binary により Permission denied または Exec format error が出る問題が記載されています。後続 version で修正されています。症状が一致する場合、実際の Docker Desktop version と更新 channel を確認します。未確認の forum 手順で内部ファイルを置き換えないでください。
同じ release notes には、Resource Saver が仮想マシンを停止した後、統合済みディストリビューションで Docker CLI が一時的に使えなくなる問題の修正も記載されています。該当するかは実際の version 次第です。キーワードだけで判断せず、Diagnostic ID と再現手順を記録します。
再現手順を小さくするには、Docker Desktop を完全終了し、wsl --shutdown を実行してから Docker Desktop を再起動します。Engine の起動を待ち、対象を一つだけ開いて docker version を実行します。各段階の時刻と出力を記録します。一つのディストリビューションだけ失敗するならそこを調べ、すべての WSL コマンドが失敗するなら WSL と Windows 機能を確認します。
一度に変更する設定は一つにします。たとえば WSL を更新して確認してから、Docker Desktop backend の変更を検討します。WSL 更新、Hyper-V/VMM の切替、データリセット、再インストールをまとめて行うと、原因の手掛かりが消え、新しい問題が加わる可能性があります。
回帰を疑う場合、Docker Desktop の About 画面と公式 release notes の日付を確認し、組織の方針に沿って更新または rollback を判断します。不明な配布元から旧 installer を入手したり、forum script で docker-desktop 内のファイルを上書きしたりしないでください。
image pull の失敗は WSL 統合の問題とは限らない
docker version に Server が表示されるのに docker pull が DNS、proxy、TLS、認証エラーになる場合、CLI は通常 Engine に接続できています。WSL 統合を何度も切り替えるのではなく、Windows の network、Docker Desktop proxy、registry 認証情報、registry address を確認します。
新しい image を取得しない状態確認から始め、完全なエラーを記録します。会社の network や VPN 使用時だけ失敗する場合は、同じ network 条件で DNS、proxy policy、社内 certificate の要件を比較します。テストのために会社の security proxy を停止したり、certificate 検証を回避したりしないでください。
docker compose up の失敗は project 設定やコンテナー内アプリケーションが原因の場合もあります。まず docker compose config で展開後の設定を確認し、失敗箇所が image pull、コンテナー作成、volume mount、アプリ起動のどこかを特定します。daemon に接続できない場合だけ WSL 統合の手順へ進みます。
Engine に接続できるのに Compose の環境変数がコンテナーへ反映されない場合は、Docker Compose 環境変数のトラブルシューティングを参照してください。データベースの準備完了やサービス起動順序については、depends_on と healthcheck のガイドを確認してください。
ディスク容量、リセット、バックアップの境界
Docker Desktop の WSL 2 engine data は通常、ユーザープロファイル配下の Docker WSL data location にありますが、設定で場所が変わっている場合があります。仮想ディスクを削除すると、ローカルの image、コンテナー、volume のデータを永久に失う可能性があります。Clean up data と Reset to factory defaults もデータを保つ再起動方法ではありません。
cleanup の前に、必要な database volume、image、コンテナーデータに独立した backup があることを確認します。コンテナーを再構築できても、volume のデータまで再構築できるとは限りません。業務環境では retention と backup policy を確認します。
Docker Desktop の診断、正常終了、再起動を優先します。データを消去したり factory reset したりするのは、影響範囲を理解して backup を確認してからにしてください。
診断情報を集めて修復を確認する
Docker Dashboard を開ける場合、Troubleshoot メニューから Get support を選びます。診断収集が終わるまで待って upload し、Diagnostic ID を保存します。UI が起動できない場合は、インストール方法に応じて公式の docker desktop diagnose command を使います。command line 対応は Docker Desktop version によって異なります。
問題を報告するときは「Docker が壊れた」だけでなく、次の情報を添えます。
- Windows と Docker Desktop の version。
wsl --version、wsl --status、wsl -l -vの出力。- 対象のディストリビューション名、WSL version、Docker Desktop backend。
- PowerShell と WSL での
docker versionの完全な出力。 docker context showと、DOCKER_HOSTまたはDOCKER_CONTEXTの設定有無。- 完全なエラー、発生時刻、直前の更新有無、Diagnostic ID。
修復後、PowerShell と対象の WSL ディストリビューションで個別に確認します。
|
|
|
|
両方のターミナルが意図したローカル Engine に接続し、docker version に Client と Server の情報が表示されれば統合確認は完了です。その後、docker compose config とプロジェクトの起動 command を実行して、mount、network、environment variable も確認します。
よくある質問
Windows では Docker が動くのに Ubuntu に docker command がありません。再インストールすべきですか?
Docker Desktop の WSL 2 engine と Ubuntu 統合を有効にし、WSL を終了して開き直してください。最初から Ubuntu に二つ目の Docker Engine を入れないでください。
docker version に Client しか表示されないのはなぜですか?
CLI は起動していますが Engine Server から応答を受け取っていません。Docker Desktop の起動状態、context、DOCKER_HOST、backend mode を確認します。
wsl --shutdown はコンテナーを削除しますか?
すべての WSL ディストリビューションと WSL 仮想マシンを停止しますが、データ削除コマンドではありません。実行中のプログラムの未保存状態は中断されます。Docker Desktop と対象ディストリビューションを再起動して確認してください。
起動を直すために docker-desktop-data を削除できますか?
内部ディストリビューションの削除を通常の修復として扱わないでください。ローカル image、コンテナー、volume が消える場合があります。診断と公式の復旧手順を確認し、backup を確認した後にのみデータ操作を検討します。
WSL で docker は動くのに Dev Containers や Testcontainers は失敗するのはなぜですか?
command が動くことは、Docker socket と Engine API のすべての利用方法が使えることを意味しません。Docker Desktop backend を確認してください。Docker VMM には socket と mount の制限があります。
公式資料
- Docker Desktop WSL 2 backend:WSL 要件、統合設定、Docker VMM の制限。
- Docker Desktop のトラブルシューティング項目:仮想化と WSL 起動エラー。
- Docker Desktop の診断とトラブルシューティング:Diagnostic ID、ログ、サポート手順。
- Docker Desktop release notes:特定 version の WSL 統合修正を確認。
- Microsoft WSL の基本コマンド:ディストリビューションの更新、確認、停止、export。