1.

Docker Desktop for Windows インストール完全ガイド(Hyper-V 有効化 / WSL2 / 動作確認)

編集
この記事の要点
  • Docker Desktop for Windows は Windows 上で Linux コンテナを動かすための公式ツール。Hyper-V または WSL2 をバックエンドに使う
  • 前提: Windows 10 / 11 の Pro / Enterprise / Education(64bit)。Home エディションは WSL2 バックエンドのみ対応
  • 事前準備: Hyper-V の有効化(または WSL2 のインストール)、Docker Hub アカウントの作成
  • インストーラは公式サイトから入手し、ウィザードに従って導入 — 完了後に PC 再起動が必要
  • 動作確認: PowerShell で docker --version / docker run hello-world が成功すれば OK

Docker Desktop for Windows とは

Docker Desktop for Windows は、Windows 上でLinux コンテナを実行するための公式アプリケーションです。Hyper-V または WSL2 上に軽量な Linux VM を立ち上げ、その中で Docker エンジンを動かす仕組みになっています。GUI ダッシュボードからイメージ / コンテナの状態を可視化できるほか、Kubernetes ノードのワンクリック起動にも対応します。

前提条件

項目要件
OSWindows 10 / 11(64bit)
エディションPro / Enterprise / Education(Home は WSL2 バックエンド限定)
CPU仮想化機能(Intel VT-x / AMD-V)対応かつ BIOS で有効
メモリ4GB 以上(推奨 8GB 以上)
アカウントDocker Hub アカウント(事前作成)

1. Hyper-V の有効化

仮想環境の構築に必要な Hyper-V を有効化します。WSL2 バックエンドを使う場合はこの手順をスキップし、後述の WSL2 セットアップへ進んでください。

  1. 「Windowsボタン」→「設定」
  2. 「アプリ」→「アプリと機能」
  3. 下にスクロールして「プログラムと機能」(Windows 11 では「関連設定」内)
  4. 「Windows の機能の有効化または無効化」
  5. Hyper-V」にチェックを入れて OK
  6. PC を再起動

Hyper-V の有効化

PowerShell から有効化することもできます。

# 管理者権限の PowerShell
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All
Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform
# 再起動
Restart-Computer

2. ダウンロードとインストール

公式サイトから Docker Desktop for Windows のインストーラ(Docker Desktop Installer.exe)をダウンロードします。

インストーラを起動するとオプション選択画面が表示されます。

Docker Desktop インストーラ

「Use Windows containers instead of Linux containers」にチェックを入れると Linux コンテナではなく Windows コンテナを導入することになります。後から GUI で切り替え可能なので、今回はチェックを入れずLinux コンテナを選択します(一般的な用途はこちら)。

インストールが終わると再起動を促されます(場合によってはもう一度再起動が必要)。

3. Docker Desktop の起動とログイン

インストールが完了するとログイン画面が表示されます。

Docker Desktop ログイン画面

事前に作成した Docker Hub アカウントの情報を入力してログインします。ログインせずにローカルでイメージをビルド / 実行することも可能ですが、Docker Hub からプライベートイメージを pull するには必須です。

4. PowerShell から動作確認

PowerShell を開きます(Cortana 検索で PowerShell と入力すれば見つかります)。

PowerShell の起動

# バージョン確認
docker --version
# Docker version 26.x.x, build xxxxxxx

# 動作確認用の hello-world コンテナを起動
docker run hello-world

"Hello from Docker!" のメッセージが表示されればインストール成功です。

5. Ubuntu コンテナの起動

続いて Ubuntu のコンテナを起動して、Linux 環境にアタッチしてみます。

# Ubuntu イメージを pull して対話モードで起動
docker run -it --name my-ubuntu ubuntu:22.04 /bin/bash

# コンテナ内のシェル(# プロンプト)
root@xxxxxxxx:/# ls -la
root@xxxxxxxx:/# cat /etc/os-release
root@xxxxxxxx:/# exit

Ubuntu コンテナの起動

コンテナを抜けた後でも、停止状態として残っています。再起動する場合は次のように操作します。

# 停止中のコンテナ一覧
docker ps -a

# 再起動して入る
docker start -i my-ubuntu

# 不要になったら削除
docker rm my-ubuntu

WSL2 バックエンドへの切り替え

Windows 10 (2004 以降) / Windows 11 では、Hyper-V よりも軽量な WSL2 をバックエンドに使う方式が推奨されています。Home エディションでも利用可能です。

# WSL2 を有効化
wsl --install
# 再起動後、デフォルトバージョンを 2 に
wsl --set-default-version 2

Docker Desktop の「Settings」→「General」→「Use the WSL 2 based engine」をオンにすると WSL2 バックエンドで動作します。

トラブルシューティング

症状対処
"Hardware assisted virtualization ... must be enabled" エラーBIOS で Intel VT-x / AMD-V を有効化
Hyper-V と VirtualBox が共存できないWindows 10 1903+ では bcdedit /set hypervisorlaunchtype off で一時無効化、または VirtualBox 6.1+ なら共存可
WSL2 への切り替えが失敗「VirtualMachinePlatform」機能の有効化と、WSL2 用 Linux カーネル更新パッケージのインストール
イメージの保存先を変えたいSettings → Resources → Advanced で「Disk image location」を変更

関連記事

編集
Post Share
子ページ

子ページはありません

同階層のページ
  1. インストール方法(Windows)
  2. イメージの検索 / 取得 / 取得済み一覧の確認
  3. use windows containers instead of linux containers docker
  4. バージョンの確認
  5. エラー一覧

最近更新/作成されたページ