Docker Desktop のインストールと初期設定(Mac/Windows)
概要
ローカル開発環境を「動くマシン」から「壊してもすぐ作り直せるマシン」に変える第一歩が Docker Desktop です。本記事では Mac / Windows それぞれで Docker Desktop をインストールし、最初に済ませておくべき初期設定と動作確認までをハンズオンでたどります。GUI 手順だけでなく、CLI での確認・リソース調整・つまずきやすいポイントまで含めてまとめます。
対象読者は「これから Docker を触りはじめるエンジニア」「新メンバーが入るたびに環境構築を案内している人」です。
環境
- macOS: Apple Silicon(M1 以降)/ Intel
- Windows: Windows 10 / 11(64bit)+ WSL2
- Docker Desktop: 執筆時点の最新安定版
バージョンは頻繁に更新されるため、具体的な番号ではなく「最新安定版を入れる」方針で説明します。
導入前に確認すること
Docker Desktop は仮想化基盤の上で動きます。インストール前に次の 3 点を確認しておくと失敗が減ります。
- CPU アーキテクチャ(Mac の場合、Apple Silicon か Intel か)
- 仮想化が有効か(Windows の場合、BIOS/UEFI で仮想化支援が有効か)
- ディスクの空き容量(イメージとボリュームで消費するため、最低でも数十 GB は確保)
Mac のアーキテクチャ判定:
uname -m # arm64 → Apple Silicon # x86_64 → Intel
インストール手順(Mac)
1. インストーラの取得
Docker 公式サイトのダウンロードページから、自分のアーキテクチャに合ったインストーラ(Apple Silicon 版 / Intel 版)を取得します。ここを間違えると起動時にエラーになるため、前述の uname -m の結果と合わせます。
2. インストール
ダウンロードした .dmg を開き、Docker アイコンを Applications フォルダにドラッグします。Applications から起動すると、初回はヘルパーのインストールで管理者パスワードを求められます。
3. 起動確認
メニューバーにクジラのアイコンが表示され running になれば起動完了です。
docker version docker info
Homebrew を使う場合:
brew install --cask docker
cask で入れても、初回だけは GUI から一度起動して初期化を済ませる必要があります。
インストール手順(Windows)
1. WSL2 の準備
Windows では WSL2 バックエンドの利用が推奨です。未導入なら管理者権限の PowerShell で有効化します。
wsl --install
実行後は一度再起動します。既存環境ではバージョンを確認します。
wsl -l -v
VERSION 列が 2 になっていれば OK です。1 の場合は変換します。
wsl --set-version <ディストリ名> 2
2. Docker Desktop のインストール
公式サイトから Windows 版インストーラ(Docker Desktop Installer.exe)を取得して実行します。インストール中に 「Use WSL 2 instead of Hyper-V」 が表示されたら有効にします。
3. 起動と WSL 連携の確認
起動後、Settings → Resources → WSL Integration を開き、開発に使うディストリビューションとの連携を有効にします。これで WSL 側のターミナルから docker コマンドがそのまま使えます。
docker version
初期設定(Mac / Windows 共通)
リソース割り当ての調整
Settings → Resources から CPU / メモリ / ディスクの割り当てを調整できます。開発用途ならメモリ 4〜8GB 程度から始め、必要に応じて増減させます。
> Windows で WSL2 バックエンドを使う場合、メモリ上限は Docker Desktop の設定ではなく WSL 側の .wslconfig で制御される点に注意します。
C:\Users\<ユーザー名>\.wslconfig の例:
[wsl2] memory=6GB processors=4
編集後は wsl --shutdown で反映します。
自動起動の設定
Settings → General の "Start Docker Desktop when you sign in" は、常用するなら ON、たまにしか使わないなら OFF が扱いやすいです。
ファイル共有(Mac)
Mac ではファイル同期方式(VirtioFS など)が選べます。大量ファイルをバインドマウントする開発では設定でパフォーマンスが変わることがあります。まずは既定のまま進め、遅さを感じたら見直します。
動作確認
hello-world で疎通確認
docker run --rm hello-world
"Hello from Docker!" が表示されれば一連の動作が確認できています。
nginx を立ててみる
docker run --rm -d -p 8080:80 --name web nginx
http://localhost:8080 で nginx の初期画面が出れば成功です。片付け:
docker stop web
稼働状態の確認コマンド
docker ps docker images docker system df
注意点
- アーキテクチャの不一致: Apple Silicon で amd64 前提イメージを動かすと遅くなったり動かないことがあります。
--platform linux/amd64で明示できますが、可能なら arm64 対応イメージを選びます。 - ポート競合: ホスト側ポートが使用中だとエラーになります。
lsof -i:8080(Mac)で確認します。 - ディスクの肥大化: 定期的に掃除します。
docker system prune docker system prune -a --volumes # 消しすぎ注意
- ライセンス: Docker Desktop は組織規模により有償ライセンスが必要になる場合があります。業務利用前に最新の利用条件を確認してください。
まとめ
Docker Desktop の導入は「入れて終わり」ではなく、アーキテクチャ確認 → インストール → リソース設定 → 動作確認 までを一続きで押さえるのが肝心です。Windows は WSL2 連携、Mac はアーキテクチャ整合が鍵。まずは hello-world と nginx で疎通を確認し、自分のプロジェクト用の環境構築へ進みましょう。
