WSLでのDockerコマンドが見つからない問題の解決方法

問題の概要

WSL (Windows Subsystem for Linux) 環境で docker コマンドを実行しようとすると、以下のエラーメッセージが表示されることがあります：

The command 'docker' could not be found in this WSL 2 distro.
We recommend to convert this distro to WSL 2 and activate
the WSL integration in Docker Desktop settings.

この問題は、Docker DesktopとWSLの連携が正しく設定されていない場合に発生します。WSL 1を使用している場合や、Dockerの設定が不適切な場合など、さまざまな原因が考えられます。

解決方法

1. WSL 2へのアップグレード

WSL 1を使用している場合は、まずWSL 2にアップグレードする必要があります。

PowerShellを管理者権限で開き、以下のコマンドを実行します：

# WSLディストリビューションの状態を確認
wsl --list --verbose

# UbuntuをWSL 2に変換（ディストリビューション名は適宜変更）
wsl --set-version Ubuntu 2

TIP

WSL 2を使用するには、Windows 10バージョン1903以降でビルド18362以上が必要です。また、Virtual Machine Platformオプション機能を有効にする必要があります。

2. Docker DesktopのWSL統合を有効化

Docker Desktopアプリケーションを開き、以下の手順で設定します：

1. 設定画面を開く
2. 「Resources」→「WSL Integration」を選択
3. 使用するWSLディストリビューション（例: Ubuntu）のトグルをオンにする

WARNING

設定を変更した後は、Docker Desktopの再起動が必要な場合があります。

3. WSL統合が表示されない場合の対処法

WSL Integrationオプションが表示されない場合は、以下の手順を試してください：

1. Docker Desktopの「General」設定で「Use the WSL2 based engine」のチェックを一度外す
2. 「Apply & Restart」をクリック
3. 再度「Use the WSL2 based engine」をチェックする
4. 「Apply & Restart」で適用する

これにより、WSL Integrationメニューが表示されるようになります。

4. シンボリックリンクの確認と修復

WSL環境内で以下のコマンドを実行し、Dockerのシンボリックリンクが正しく設定されているか確認します：

ls -l /usr/bin/ | grep docker

正常な場合、以下のようなシンボリックリンクが表示されます：

lrwxrwxrwx 1 root root  56 Jul 14 13:01 com.docker.cli -> /mnt/wsl/docker-desktop/cli-tools/usr/bin/com.docker.cli
lrwxrwxrwx 1 root root  48 Jul 14 13:01 docker -> /mnt/wsl/docker-desktop/cli-tools/usr/bin/docker
lrwxrwxrwx 1 root root  56 Jul 14 13:01 docker-compose -> /mnt/wsl/docker-desktop/cli-tools/usr/bin/docker-compose

シンボリックリンクが壊れているまたはディレクトリになっている場合、以下のコマンドで修復できます：

# 壊れたリンクやディレクトリを削除
sudo rm -rf /usr/bin/docker

# 正しいシンボリックリンクを作成
sudo ln -s /mnt/wsl/docker-desktop/cli-tools/usr/bin/docker /usr/bin/docker

5. Docker Desktopのデータをクリーンアップ

Docker Desktopのトラブルシューティングオプションを使用してデータをクリーンアップします：

1. Docker Desktopの右上にあるトラブルシュートアイコン（虫のマーク）をクリック
2. 「Clean/Purge Data」を選択
3. 「WSL 2」のみにチェックを入れ、「Delete」をクリック
4. Dockerを再起動する

6. ユーザーグループの確認

WindowsでDockerを使用するには、ユーザーアカウントが「docker-users」グループに属している必要があります。

PowerShellを管理者権限で開き、以下のコマンドを実行します：

# ローカルアカウントの場合
net localgroup docker-users "あなたのユーザーID" /ADD

# ドメインアカウントの場合
net localgroup docker-users "ドメイン名\あなたのユーザーID" /ADD

変更を反映するために、コンピューターの再起動が必要です。

7. PATH設定の確認

WSL環境でPATHの順序が正しく設定されているか確認します：

echo $PATH
which docker

/usr/binがPATHの先頭に来るように設定します：

export PATH="/usr/bin:$PATH"

この設定を恒久化するには、~/.bashrcファイルに追加します。

8. Docker Desktopの再インストール

上記の方法で解決しない場合、Docker Desktopの再インストールを検討してください：

1. Docker Desktopをアンインストール
2. すべてのWSLディストリビューションを削除または更新
3. Docker Desktopを再インストール
4. WSL統合を再度有効化

予防策とベストプラクティス

1. 起動順序: Docker Desktopを起動してからWSLを開くようにします
2. 定期的な更新: Docker DesktopとWSLディストリビューションを最新の状態に保ちます
3. バックアップ: 重要なDocker環境は定期的にバックアップします
4. ログの確認: 問題が発生した場合は、Docker Desktopのログを確認します

まとめ

WSL環境でDockerコマンドが見つからない問題は、主にDocker DesktopとWSLの連携設定に関する問題です。最も一般的な解決策は、WSL 2の使用とDocker DesktopでのWSL統合の有効化です。問題が解決しない場合は、シンボリックリンクの修復やDockerデータのクリーンアップなどの追加のトラブルシューティング手順を試してください。

INFO

DockerとWSLの連携はバージョンによって挙動が変わる場合があります。公式ドキュメントで最新の情報を確認することをお勧めします。