Contents
1. 概要とシステム要件
重要ポイント
- OS:Windows 11 Pro または Enterprise(ビルド 22000 以降)
- 仮想化支援機能:BIOS/UEFI で Intel VT‑x もしくは AMD‑V を有効化
- WSL 2:必ずインストールし、Linux カーネルを最新に保つ(wsl --update)
| 項目 | 必要条件・推奨値 |
|---|---|
| OS | Windows 11 Pro / Enterprise |
| 仮想化 | BIOS/UEFI で Intel VT‑x または AMD‑V を有効 |
| WSL バージョン | WSL 2 がインストール済み、wsl --update により Linux カーネルを最新に |
| メモリ | 最低 4 GB(実務では 8 GB 以上) |
| ストレージ | Docker イメージ用に空き容量 20 GB 以上 推奨 |
| ライセンス | 個人利用は無料プラン、商用・企業利用はサブスクリプションが必要 |
備考:Home エディションでも WSL 2 は使用可能ですが、Docker Desktop のフル機能(Hyper‑V バックエンド)は Pro/Enterprise が公式にサポートされています。
2. WSL 2 と Hyper‑V の有効化手順
手順概要
- 管理者権限 PowerShell を起動
- 必要な Windows 機能を有効化
- PC を再起動し、設定が反映されたことを確認
|
1 2 3 4 5 6 |
# ① WSL 2 の有効化 dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart # ② Hyper‑V の有効化 Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V-All -NoRestart |
再起動後の確認ポイント
| 確認項目 | 方法 |
|---|---|
| Virtual Machine Platform | 「Windows の機能」画面でチェックが入っているか |
| Windows Subsystem for Linux | 同上 |
| Hyper‑V(すべて) | 同上 |
トラブルシューティング
- BIOS で仮想化支援が無効の場合は「Virtualization Technology」や「Secure Boot」の設定を見直してください。
- 機能が表示されないときは、最新の Windows Update が適用済みかも併せて確認しましょう。
3. Docker Desktop インストーラの取得とインストール
公式サイトからダウンロード
- Docker の公式ドキュメント https://docs.docker.jp/desktop/install/windows-install.html にアクセス
- 「Download Docker Desktop for Windows」ボタンをクリック →
Docker Desktop Installer.exeが自動的に保存されます
インストーラ実行手順(管理者権限必須)
| インストール画面項目 | 推奨設定 |
|---|---|
| WSL 2 バックエンドを使用 | ✅ デフォルトでチェック済み |
| Hyper‑V のインストール | 必要に応じて自動有効化(既に有効ならスキップ) |
| Desktop shortcut | 任意で作成可 |
- ダウンロードした
Docker Desktop Installer.exeを右クリック → 「管理者として実行」 - 上記テーブルの設定を確認し、[Install] をクリック
- インストール完了後に再起動が求められた場合は指示通りに実施
※将来予測情報
2025 年以降のリリースでは「自動更新機能」が標準搭載されると公式アナウンスがありますが、現時点(2024‑11)では未確認です。企業環境で自動更新を無効化したい場合は、Settings → General → Automatically check for updates をオフにしてください。
4. 初回起動と基本設定
| 設定項目 | 推奨値・ポイント |
|---|---|
| Docker Hub サインイン | 無料プランで個人利用可、企業はサブスクリプションを選択 |
| CPU | デフォルト 2 コア → 開発に合わせて 4 コア 程度推奨 |
| Memory | デフォルト 2 GB → 少なくとも 4 GB、快適さ重視なら 8 GB 推奨 |
| Disk image size | デフォルト 64 GB → 必要に応じて拡張(docker system prune で不要イメージは削除可) |
| WSL Integration | 「Enable integration with my default WSL distro」または個別ディストリビューションをオン |
- Docker Desktop 起動 → Sign in to Docker Hub ボタンからサインイン
- Settings → Resources で CPU・メモリ・Disk の上限を調整し、Apply & Restart をクリック
- Settings → WSL Integration で使用中の Linux ディストリビューション(例: Ubuntu)を有効化
設定が反映されたら docker context ls で default が wsl と表示されることを確認してください。
5. 動作確認とよくあるエラー対処
基本チェックコマンド
|
1 2 3 |
docker version docker run hello-world |
- 期待結果:
Client:とServer:のバージョン情報が表示され、hello-worldコンテナから “Hello from Docker!” が出力される。
代表的なエラーと対処法
| エラーメッセージ | 原因概要 | 推奨対策 |
|---|---|---|
client version xx is too old |
Docker Engine が新バージョンに更新されたが、クライアントが古い | Docker Desktop を再起動し、必要なら Settings → Reset → Restart |
WSL 2 has not been started |
WSL 2 のバックエンドが停止中 | 管理者 PowerShell で wsl --shutdown 後に wsl 再起動、または「サービス」から LxssManager を再起動 |
Error while loading shared libraries: libstdc++.so.6 (Linux コンテナ) |
WSL 2 の Linux カーネルが古い | wsl --update でカーネル更新、Docker Desktop 再起動 |
Docker Desktop is not responding |
Hyper‑V が無効、または VirtualBox 等の仮想化ソフトと競合 | Hyper‑V 機能を再確認し、競合アプリを一時停止またはアンインストール |
Failed to connect to daemon socket at unix:///var/run/docker.sock |
Docker Engine が起動していない | Settings → General で “Start Docker Desktop when you log in” を有効化し、手動で再起動 |
補足:ログの確認方法
- PowerShell で
Get-EventLog -LogName Application -Source "Docker Desktop" - Windows の「イベントビューア」 → Windows Logs → Application → ソースが Docker Desktop のエントリをチェック
6. 追加で知っておきたいポイント
| 項目 | 内容 |
|---|---|
| 自動更新の扱い | 前述の通り、2025 年以降に自動更新が標準化される可能性があります。企業環境ではポリシーに合わせて手動管理を推奨。 |
| セキュリティ | Docker Desktop は Windows のシステム権限で動作します。信頼できないイメージは必ず docker scan で脆弱性チェックを行いましょう。 |
| クリーンアップ | 定期的に docker system prune -a --volumes を実行し、未使用イメージ・コンテナ・ボリュームを削除するとストレージの肥大化を防げます。 |
| WSL 2 のバックエンド切替 | 必要に応じて Settings → General → Use the WSL 2 based engine をオン/オフでき、Hyper‑V が利用できない環境でも動作確認が可能です(ただしパフォーマンスは劣ります)。 |
7. まとめ
| 手順 | キーポイント |
|---|---|
| システム要件 | Windows 11 Pro/Enterprise + BIOS の仮想化有効化が必須 |
| WSL 2 / Hyper‑V 有効化 | 管理者 PowerShell で機能追加 → 再起動後に UI でも確認 |
| インストーラ取得 | Docker 公式サイトから最新版をダウンロードし、WSL 2 バックエンドを選択してインストール |
| 初回設定 | Docker Hub にサインイン → CPU・メモリ・ディスク容量と WSL 2 統合を環境に合わせて調整 |
| 動作確認 | docker version と docker run hello-world が正常に実行できれば完了 |
| エラー対処 | 代表的なエラーメッセージごとに WSL 再起動・Docker Desktop 再起動・クライアント更新を実施 |
上記の手順通りに設定すれば、Windows 11 環境で最新の Docker Desktop を快適に利用開始できます。疑問点やエラーが残る場合は公式ドキュメントおよびコミュニティフォーラム(Stack Overflow, GitHub Discussions)を参照してください。