Contents
スポンサードリンク
1️⃣ 対応 OS とハードウェア要件
| 項目 | 必須条件 |
|---|---|
| OS | Windows 10 バージョン 22H2 以降、または Windows 11 |
| CPU | 64‑bit、Intel VT‑x または AMD‑V が有効化されていること |
| メモリ | 4 GB 以上 (推奨 8 GB) |
| ディスク空き容量 | 本体インストールに最低 2 GB、イメージ保存用に余裕を持たせること |
| BIOS/UEFI 設定 | “Virtualization Technology” が ON であること |
ポイント
- Docker Desktop は WSL 2 上の Linux カーネル上で動作します。したがってハイパーバイザー機能（VT‑x/AMD‑V）が必須です。
- Windows 10 Home でも、バージョン 22H2 以降なら公式にサポートされています。
2️⃣ WSL 2 の有効化と Linux カーネル更新
2.1 必要な Windows 機能を有効化
管理者権限で PowerShell を起動し、以下のコマンドを実行します。
|
1 2 3 4 |
# 仮想マシンプラットフォーム と WSL の両方を有効にする dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart |
※ 再起動は必須です
コマンド実行後、すぐに再起動しないと機能が有効になりません。
2.2 WSL 2 と Linux ディストリビューションのインストール
|
1 2 3 |
# Ubuntu (最新版) を自動で取得・インストール wsl --install -d Ubuntu |
- インストールが完了したら、
wsl -l -vで Ubuntu がバージョン 2 と表示されることを確認してください。
2.3 Linux カーネル更新パッケージの適用
Microsoft が提供する最新カーネルは以下から取得できます。
- ダウンロード URL: https://aka.ms/wsl2kernel
- ファイル名:
wsl_update_x64.msi
|
1 2 3 4 |
# 例：PowerShell で自動ダウンロード & インストール Invoke-WebRequest -Uri "https://aka.ms/wsl2kernel" -OutFile "$env:TEMP\wsl_update_x64.msi" Start-Process msiexec.exe -ArgumentList "/i `"$env:TEMP\wsl_update_x64.msi`" /quiet /norestart" -Wait |
インストール後は必ず再起動 してください。
3️⃣ Docker Desktop Installer の取得と検証
3.1 公式サイトからダウンロード
- URL: https://www.docker.com/products/docker-desktop/
「Docker Desktop for Windows」ボタンをクリックして最新版のDocker Desktop Installer.exeを取得します。
3.2 SHA‑256 ハッシュで整合性を確認
|
1 2 3 4 5 |
# ダウンロードしたファイルのハッシュを計算 $hash = Get-FileHash -Algorithm SHA256 ".\Docker Desktop Installer.exe" | Select-Object -ExpandProperty Hash Write-Output "Calculated hash: $hash" |
公式ページ下部に記載されているハッシュ文字列と 完全一致 すれば、改ざんされていないことが確認できます。
4️⃣ GUI インストーラーでの標準インストール手順
| 手順 | 操作内容 |
|---|---|
| 1. 実行 | Docker Desktop Installer.exe を右クリック → 「管理者として実行」 |
| 2. 利用規約に同意 | 「I accept the terms of the Docker Subscription Service Agreement」にチェック |
| 3. オプション選択 | - WSL 2 バックエンド使用（デフォルト） - ショートカット作成 (任意) - データ保存先は C:\ProgramData\DockerDesktop が推奨 |
| 4. インストール開始 | 「Install」ボタンをクリック。インストーラがバックグラウンドで必要ファイルを展開します |
| 5. 再起動 | 完了後に表示される「Close and restart」を選択し、システムを再起動 |
ベストプラクティス
- インストール先はデフォルト (C:\Program Files\Docker) のままで問題ありませんが、別ディレクトリへ変更する場合は パスにスペースが含まれることを考慮して必ずクオート してください（例:"C:\Program Files\Docker"）。
5️⃣ PowerShell/コマンドプロンプトでのサイレントインストール
5.1 基本コマンド (管理者権限)
|
1 2 3 4 5 |
# パスにスペースがある場合は必ず二重引用符で囲む Start-Process -FilePath "C:\Program Files\Docker\Docker Desktop Installer.exe" ` -ArgumentList "--quiet", "--accept-license", '--install-dir="C:\Program Files\Docker"', "--use-wsl2" ` -Wait -NoNewWindow |
| フラグ | 説明 |
|---|---|
--quiet |
GUI を表示せずにインストール |
--accept-license |
利用規約に自動同意 |
--install-dir |
インストール先ディレクトリ（必ずクオート） |
--use-wsl2 |
明示的に WSL 2 バックエンドを使用 |
5.2 Windows Defender の一時無効化 (必要な場合)
⚠️ セキュリティ注意
- インストーラがファイルを書き込む際にリアルタイム保護が干渉することがあります。作業が完了したら必ず Windows Defender のリアルタイム保護を元に戻す ことが重要です。
|
1 2 3 4 5 6 7 8 |
# 1. リアルタイム保護の一時無効化 (管理者権限) Set-MpPreference -DisableRealtimeMonitoring $true # 2. サイレントインストール実行（上記コマンド） # 3. インストール完了後にリアルタイム保護を再有効化 Set-MpPreference -DisableRealtimeMonitoring $false |
6️⃣ 初回セットアップ・動作確認
6.1 Docker Desktop の起動と設定
- スタートメニュー → 「Docker Desktop」
- 起動画面で「WSL 2 バックエンドを使用しますか？」と聞かれたら Yes。
- Settings → Resources → Advanced で CPU、メモリ、ディスクサイズを必要に応じて調整（デフォルトは CPU 2 コア / メモリ 4 GB / ディスク 64 GB）。
6.2 動作確認コマンド
|
1 2 |
docker version |
期待される出力例（抜粋）
|
1 2 3 4 5 6 7 8 9 |
Client: Docker Engine - Community Version: 24.0.5 API version: 1.44 ... Server: Docker Desktop 24.0.5 (62684) Engine: Version: 24.0.5 API version: 1.44 |
|
1 2 |
docker run --rm hello-world |
期待される出力例（抜粋）
|
1 2 3 4 |
Hello from Docker! This message shows that your installation appears to be working correctly. ... |
7️⃣ よくあるエラーと対処法
| エラーメッセージ | 主な原因 | 解決策 |
|---|---|---|
| Virtualization is disabled | BIOS/UEFI で VT‑x／AMD‑V が OFF | 再起動 → BIOS 設定画面 → “Intel Virtualization Technology” または “SVM Mode” を ON にする |
| WSL 2 is not installed | wsl --list に Linux ディストリビューションが無い |
前述の wsl --install -d Ubuntu を再実行し、wsl -l -v でバージョン 2 が確認できるまで繰り返す |
| Docker Desktop のインストーラがブロックされた | Windows Defender のリアルタイム保護がファイルを隔離 | 上記 §5.2 の手順で一時的に保護を無効化し、完了後は必ず有効化する |
| Client API version mismatch | Docker Desktop 更新後に古い CLI が残存 | docker system prune -a 後に PC を再起動、または最新の CLI を再インストール |
8️⃣ 完全アンインストール手順
- 設定 → アプリと機能 から「Docker Desktop」を選択し、「アンインストール」
- 残存フォルダを削除
|
1 2 3 4 |
Remove-Item -Recurse -Force "$Env:ProgramFiles\Docker" Remove-Item -Recurse -Force "$Env:AppData\Docker" Remove-Item -Recurse -Force "$Env:LocalAppData\DockerDesktop" |
- WSL 2 のクリーンアップ（必要に応じて）
|
1 2 3 4 |
wsl --unregister Ubuntu dism.exe /online /disable-feature /featurename:VirtualMachinePlatform dism.exe /online /disable-feature /featurename:Microsoft-Windows-Subsystem-Linux |
9️⃣ トラブルシューティングのための便利コマンド集
| コマンド | 用途 |
|---|---|
wsl -l -v |
インストール済みディストリビューションとバージョンを一覧表示 |
Get-WindowsOptionalFeature -Online \| Where-Object {$_.State -eq "Enabled"} |
有効化されている Windows のオプション機能を確認 |
docker system info |
Docker エンジンの詳細情報（リソース割り当て状況等） |
Get-EventLog -LogName Application -Source DockerDesktop |
Docker Desktop に関する Windows イベントログを取得 |
10️⃣ 次に挑戦したいこと
- Docker Compose を使ってマルチコンテナアプリケーションを構築
- Dev Containers（VS Code Remote – Containers）で開発環境をコード化
- GitHub Actions のセルフホストランナーとして Windows + Docker 環境を利用
公式ドキュメントやコミュニティ記事は随時更新されるので、最新情報は以下リンクからチェックしてください。
- Docker Docs（Windows インストール）: https://docs.docker.jp/desktop/install/windows-install.html
- Zenn 記事（令和7年版）: https://zenn.dev/upgradetech/articles/8e8b82e9d5c494
- Qiita 解説（2026 年版）: https://qiita.com/honda-dev-jp/items/a372b11f47052dc20e8a
📌 まとめ
- OS・ハードウェア要件 を満たすことがインストール成功の第一歩。
- WSL 2 とカーネル更新 は必ず実行し、再起動で有効化する。
- インストーラは公式サイトから取得し、SHA‑256 ハッシュで検証 する。
- パスにスペースが含まれる場合は 必ずクオート（例:
"C:\Program Files\Docker"）。 - Windows Defender を一時的に無効化する際は、作業完了後に リアルタイム保護を再有効化 してセキュリティを確保。
- サイレントインストール・GUI インストールどちらでも、管理者権限で実行し、エラーが出たら上記トラブルシューティング表を参照。
これで Docker Desktop for Windows の導入は完了です。次はコンテナの基本操作や自作イメージのビルドに挑戦してみましょう！ 🚀
スポンサードリンク