Contents
1. はじめに
Windows 11 上でコンテナ開発環境を構築したい方向けに、Docker Desktop のシステム要件からインストール手順、初回セットアップ、よくあるトラブル対策までを体系的にまとめました。本文は 2024 年時点の最新情報に基づいており、将来的に情報が変わっても参照しやすいよう「バージョン番号」ではなく 「最新版」 と表記しています。
2. Docker Desktop のシステム要件（Windows 11）
2.1 OS・CPU の最低条件
| 項目 | 必須条件 |
|---|---|
| OS | Windows 11 64‑bit（ビルド 22000 以降） |
| CPU | Intel VT‑x または AMD‑V 対応、BIOS/UEFI で有効化が必要 |
CPU が仮想化支援機能に対応していないと、Hyper‑V や WSL2 が起動できません。BIOS 設定画面で 「Virtualization Technology」 を Enabled にしてください。
2.2 メモリ・ディスク容量
- メモリ：最低 4 GB、推奨 8 GB 以上（複数コンテナを同時に動かす場合は更に多めが望ましい）
- ストレージ：Docker のイメージやボリューム用に少なくとも 20 GB の空き領域。SSD を使用すると I/O パフォーマンスが大幅に向上します。
2.3 必須コンポーネント
| コンポーネント | 有効化方法 |
|---|---|
| Hyper‑V | Windows の「機能の有効化または無効化」もしくは PowerShell (Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V-All) |
| Virtual Machine Platform | 同上、VirtualMachinePlatform を有効化 |
| Windows Subsystem for Linux 2（WSL2） | wsl --install コマンドで自動インストール、または GUI から有効化 |
ポイント：Docker Desktop は内部で Linux カーネル (WSL2) または Hyper‑V のいずれかを利用します。公式ドキュメントでも「Hyper‑V と WSL2 が有効」ことが前提条件と明記されています。
2.4 参考リンク
- Docker Desktop Windows インストールガイド（公式）: https://docs.docker.com/desktop/setup/install/windows-install/
3. WSL2 と Hyper‑V の有効化手順
3.1 PowerShell での一括有効化
管理者権限で PowerShell を起動し、以下のコマンドを実行します。再起動が必要な場合は自動的に促されます。
|
1 2 3 4 5 6 7 8 9 10 |
# ① WSL と Ubuntu 22.04 のインストール（WSL2 がデフォルトになる） wsl --install -d Ubuntu-22.04 # ② Hyper‑V と Virtual Machine Platform を有効化 Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V-All -NoRestart Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform -NoRestart # ③ 再起動（必須） Write-Host "設定を反映するために再起動します…" ; Restart-Computer |
補足
- wsl --install は Windows 11 22H2 以降で利用可能です。
- コマンド実行後は「Ubuntu-22.04」ディストリビューションが自動的に登録され、WSL2 が有効化された状態になります。
3.2 設定アプリ（GUI）での確認・変更手順
コマンド操作に不安がある場合は、以下の GUI 手順で同等の設定が行えます。
- 設定 > アプリ > オプション機能 → 「その他の Windows の機能」リンクをクリック
- リストから 「Hyper-V」「Virtual Machine Platform」「Windows Subsystem for Linux」 にチェックを入れる
- 変更後に表示される 「再起動」 ボタンで PC を再起動
3.3 有効化失敗時のトラブルシューティング
| 症状 | 原因例 | 対処法 |
|---|---|---|
| 「Hypervisor is not running」エラー | BIOS で仮想化が無効 | 再起動時に BIOS/UEFI に入り、Virtualization Technology を Enabled にする |
| WSL2 カーネルバージョンが古い | wsl --update が未実行 |
管理者 PowerShell で wsl --update && wsl --set-default-version 2 を実行 |
| 機能追加後に再起動を忘れた | DISM による変更が反映されていない | 再起動後、dism /online /get-features | find "Microsoft-Hyper-V" で有効状態を確認 |
4. Docker Desktop のインストーラ取得とインストール
4.1 ダウンロード方法の選択基準
| 項目 | 公式サイトからダウンロード | Microsoft Store |
|---|---|---|
| バージョン管理 | 任意のバージョンを取得可能 | 常に最新版のみ |
| 自動更新 | 手動で「Check for updates」必要 | デフォルトで自動更新 |
| 管理者権限 | 必要（インストーラ実行） | 不要（Store が処理） |
| エンタープライズ向け機能 | プロキシ設定・ライセンス管理が可能 | 制限あり |
推奨：企業環境や社内 CI/CD パイプラインで固定バージョンを使用したい場合は公式サイト、個人利用で手間を省きたい場合は Microsoft Store を選択してください。
4.2 インストール時のオプション解説
| チェック項目 | 推奨設定 | 理由 |
|---|---|---|
| Use the WSL 2 based engine | ON（デフォルト） | WSL2 が軽量かつ高速。Hyper‑V はバックアップ用途に限定 |
| Install required Linux kernel update | 必ずチェック | カーネル更新が未適用だと Docker Engine の起動失敗につながる |
| Enable automatic updates | ON（推奨） | 定期的なパッチ適用でセキュリティリスクを低減 |
インストールウィザードは数ステップで完了し、設定は後から「Settings > General」でも変更可能です。
4.3 インストール後の初期設定ポイント
- Docker Desktop を起動 → 初回起動時に WSL2 エンジンの有効化確認が表示されるのでそのまま進める。
- Settings > Resources > WSL Integration で使用するディストリビューション（例: Ubuntu‑22.04）をオンにし、Apply & Restart をクリック。
5. 初回セットアップと動作確認
5.1 Docker ID でのサインイン
Docker Desktop の右上にある 「Sign in」 ボタンから Docker Hub アカウント（Docker ID）でログインします。サインインするとプライベートリポジトリや自分のイメージへのアクセスが即座に可能になります。
5.2 WSL2 ディストリビューションの選択
設定画面 Settings > Resources > WSL Integration にて、デフォルト以外のディストリビューションを使用したい場合は一覧からチェックしてください。Ubuntu‑22.04 が推奨される理由は公式ドキュメントで最も安定した LTS 版として扱われているためです。
5.3 基本コマンドによる動作確認
|
1 2 3 4 5 6 |
# Docker のバージョン情報を表示 docker version # Hello World コンテナの実行（イメージ取得＋起動） docker run --rm hello-world |
期待される出力例
|
1 2 3 4 |
Hello from Docker! This message shows that your installation appears to be working correctly. ... |
この 2 コマンドがエラーなく完了すれば、Docker Desktop のインストールは成功です。
5.4 推奨設定のまとめ
| 設定項目 | 推奨値 |
|---|---|
| リソース > CPU | 必要に応じて 2 コア以上割り当て |
| リソース > メモリ | 最低 4 GB、推奨 8 GB+ |
| General > Start Docker Desktop when you log in | ON（自動起動） |
| General > Send usage statistics | 任意（プライバシー方針に合わせて） |
6. よくあるエラーと対処法
| エラーメッセージ | 主な原因 | 解決手順 |
|---|---|---|
| Hypervisor is not running | BIOS の仮想化が無効 | BIOS/UEFI に入り Virtualization Technology を有効化し再起動 |
| WSL 2 kernel version is outdated | カーネルが古い | 管理者 PowerShell で wsl --update && wsl --set-default-version 2 を実行 |
| Network is unreachable / docker pull がタイムアウト | ファイアウォールやプロキシ設定の不備 | Windows Defender の「許可されたアプリ」に Docker 関連 exe を追加、または Settings > Resources > Proxy に社内プロキシ情報を入力 |
| Docker Desktop が起動しない（エラーコード 0x80070005） | 権限不足またはアンチウイルスがブロック | 管理者権限で再実行、もしくは使用中のセキュリティソフトに例外ルールを設定 |
上記以外の症状が出た場合は Docker Desktop の Troubleshoot メニューからログを取得し、公式フォーラムや GitHub Issues で検索すると同様事象と解決策が見つかることが多いです。
7. アップデート・アンインストール手順
7.1 更新方法
- 自動更新：Settings > General の「Check for updates」スイッチが ON になっていると、バックグラウンドで定期的に最新版を取得します。
- 手動更新：公式サイトのダウンロードページから最新
.exeを入手し実行すると、設定や既存イメージは保持されたまま上書きインストールが行われます。
7.2 完全アンインストール手順
- Docker Desktop UI → Settings > Troubleshoot > Reset > 「Uninstall Docker Desktop」
- Windows の「設定 > アプリ > アプリと機能」からも同様に削除可能です。
- 残存データを完全に削除したい場合は、管理者 PowerShell で以下を実行してください。
|
1 2 3 4 5 6 7 8 9 |
# ユーザープロファイル下の Docker データフォルダを削除 Remove-Item -Recurse -Force "$Env:APPDATA\Docker" Remove-Item -Recurse -Force "$Env:LOCALAPPDATA\Docker" Remove-Item -Recurse -Force "$Env:USERPROFILE\.docker" # WSL 側の Docker 用ディストリビューションを削除 wsl --unregister docker-desktop wsl --unregister docker-desktop-data |
これでシステムから Docker Desktop 関連ファイルがすべて除去されます。
8. まとめと次のアクション
| 項目 | 要点 |
|---|---|
| システム要件 | Windows 11 64‑bit、CPU の VT‑x/AMD‑V 有効化、最低 4 GB RAM、Hyper‑V と WSL2 を有効にする |
| 有効化手順 | PowerShell (wsl --install + Enable-WindowsOptionalFeature) または設定アプリで 3 つの機能をオン → 再起動 |
| インストール | 公式サイトまたは Microsoft Store から最新版 .exe を取得、インストーラの「Linux カーネル自動更新」＋「自動アップデート」を必ずオンに |
| 初回セットアップ | Docker ID でサインイン → Ubuntu‑22.04 の WSL2 統合を有効化 → docker version・docker run hello-world で正常起動確認 |
| トラブル対策 | BIOS 仮想化、WSL カーネル更新、ネットワーク例外設定の3点を中心にチェック |
| 保守 | 自動更新が有効なら放置可、手動更新は最新版インストーラで上書きインストール。アンインストール時は UI + 残存フォルダ削除で完全クリーンアップ |
次のステップ
1. 本ガイドに沿って環境を構築し、docker run hello-worldが成功したことを確認する。
2. 必要に応じて Docker Compose や Kubernetes (Docker Desktop の Kubernetes オプション) を有効化し、マルチコンテナ・オーケストレーション環境へ拡張する。
以上の手順を実施すれば、Windows 11 上で安全かつ安定した Docker 開発基盤が整います。 Happy Dockering!