ステップバイステップガイド: Windows と macOS への Docker Desktop のインストール

Docker Desktop は、Windows または macOS のラップトップでコンテナを実行したい場合の通常の出発点です。インストールは簡単ですが、いくつかのシステム設定がインストーラーの完了後に Docker の起動を妨げる可能性があります。

このガイドでは、Windows と macOS に Docker Desktop をインストールし、Docker CLI、Docker Engine、テストコンテナが正しく動作することを確認する手順を説明します。

Docker Desktop がインストールするもの

Docker Desktop は、Docker CLI、Docker Engine、Docker Compose、デスクトップダッシュボード、オプションの Kubernetes サポートを含むローカル Docker 環境を提供します。Windows では、Docker Desktop は通常 WSL 2 を介して Linux コンテナを実行します。macOS では、軽量の Linux 仮想マシン内でコンテナを実行します。

日常的な開発では、次のようなコマンドを実行できます:

docker run hello-world
docker compose up
docker build -t my-app .

最初に別の Docker Engine パッケージをインストールする必要はありません。

最初に要件を確認する

Docker はプラットフォーム要件を随時変更するため、古いマシンにインストールする前に Docker の現在のドキュメントを確認してください。ほとんどの現在のセットアップでは、以下の基本事項を確認する必要があります。

Windows の要件

サポートされている 64 ビット版の Windows を使用し、Windows を最新の状態に保ってください。Docker Desktop は WSL 2 バックエンドで最もよく動作するため、セットアップの前または中に WSL をインストールしてください:

wsl --install

管理者権限の PowerShell またはコマンドプロンプトからそのコマンドを実行し、Windows から要求されたら再起動してください。

また、ハードウェア仮想化を確認してください。タスクマネージャーを開き、パフォーマンス タブに移動し、CPU を選択して、仮想化: 有効 と表示されているか確認します。無効になっている場合は、BIOS または UEFI 設定で有効にしてください。

Docker Desktop はデスクトップ Windows 環境向けであり、Windows Server 向けではありません。

macOS の要件

Apple シリコンまたは Intel Mac のいずれかで、サポートされている macOS リリースを使用してください。お使いのチップタイプに適したインストーラーをダウンロードしてください。お使いの Mac がわからない場合は、Apple メニュー > この Mac について を開き、チップまたはプロセッサの行を確認してください。

Docker Desktop は、Linux VM を実行しイメージを保存するために十分なメモリとディスク容量を必要とします。ローカルでデータベースやマルチサービススタックを実行する予定がある場合は、インストール後に設定で Docker により多くのメモリを割り当ててください。

Windows に Docker Desktop をインストールする

Docker の公式ウェブサイトから Docker Desktop をダウンロードしてください。開発ツールについては、サードパーティのダウンロードミラーは避けてください。

.exe インストーラーを実行し、表示されたら WSL 2 オプションを有効にしたままにしてください。インストーラーが必要な Windows コンポーネントの追加を提案した場合は、許可してください。インストール後、プロンプトが表示されたらコンピューターを再起動してください。

スタートメニューから Docker Desktop を開きます。初回起動時に、ライセンス条項に同意し、Docker がセットアップを完了するのを待ちます。Docker が WSL の問題を報告した場合は、WSL を更新して再試行してください:

wsl --update

社用ラップトップを使用している場合、エンドポイントセキュリティソフトウェアが仮想化やローカルネットワークに干渉する可能性があります。その場合は、ファイアウォールやウイルス対策設定を変更する前に、会社の Docker Desktop ポリシーを確認してください。

macOS に Docker Desktop をインストールする

Docker の公式ウェブサイトから Mac 用の Docker Desktop をダウンロードしてください。M シリーズ Mac には Apple シリコン用インストーラーを、Intel Mac には Intel 用インストーラーを選択してください。

.dmg ファイルを開き、Docker をアプリケーションフォルダにドラッグします。アプリケーションから Docker を起動します。macOS は、ネットワーキングと仮想化に使用されるヘルパーコンポーネントをインストールするためにパスワードまたは許可を求める場合があります。

Docker Desktop が起動したら、メニューバーのアイコンが Docker の実行中を示すまで待ちます。初回起動は、Docker がローカル VM とストレージを作成するため、時間がかかることがあります。

インストールの確認

ターミナルを開き、Docker クライアントとサーバーを確認します:

docker version

クライアントセクションとサーバーセクションの両方が表示されるはずです。クライアント情報のみ、またはデーモンへの接続に関するエラーが表示される場合は、Docker Desktop がまだ実行されていないか、起動に失敗しています。

標準のテストコンテナを実行します:

docker run hello-world

Docker は小さなイメージをダウンロードして実行します。成功すると、Docker が動作していることを説明するメッセージが表示されます。

Docker Compose も確認できます:

docker compose version

Docker Desktop に含まれている Compose v2 には、スペース区切りの docker compose コマンドを使用してください。

最初の設定を調整する

最初のテストが成功したら、Docker Desktop の設定を開きます。

Windows では、リソース > WSL 統合 を確認し、開発コマンドを実行する Linux ディストリビューションの統合を有効にします。WSL で Ubuntu を使用している場合、これにより Ubuntu シェルから docker を実行できるようになります。

Windows と macOS の両方で、リソース を確認してください。小規模なプロジェクトではデフォルトで問題なく動作する場合がありますが、ローカル Kubernetes、データベース、大規模なビルドでは、より多くのメモリやディスク容量が必要になることがよくあります。

ローカルのシングルノードクラスターが必要な場合のみ、Kubernetes を有効にしてください。オフのままにしておくと、Docker Desktop が軽量に保たれます。

よくあるインストールの問題

Windows で Docker が起動しない場合は、まず仮想化が有効で WSL がインストールされていることを確認してください:

wsl --status

WSL が古い場合は、次を実行します:

wsl --update

docker version が Docker デーモンに接続できない場合は、Docker Desktop が実行中で起動が完了していることを確認してください。macOS ではメニューバーのアイコンを確認してください。Windows ではシステムトレイを確認してください。

テストコンテナがネットワークに到達できない場合は、別のネットワークまたは VPN の状態でテストしてください。VPN クライアントや企業プロキシは、Docker のネットワーキングに影響を与えることがよくあります。Docker Desktop には、環境で必要な場合に設定できるプロキシ設定があります。

docker run hello-world が動作すれば、ローカルコンテナ環境の準備は完了です。次のステップとして、既に知っているサービス（Nginx など）を 1 つ実行することをお勧めします:

docker run --rm -p 8080:80 nginx

次に、http://localhost:8080 を開きます。Nginx のウェルカムページが表示されれば、Docker はイメージをプルし、コンテナを起動し、マシン上でポートを公開できます。