Docker

Docker Desktop Mac M2 インストール手順 – macOS Ventura での設定方法

ⓘ本ページはプロモーションが含まれています

スポンサードリンク

1. 必要な環境とハードウェア要件

条件 内容
OS macOS Ventura (13.x) 以降。Catalina 以下では Virtualization.framework が提供されないため動作しません。
CPU Apple Silicon (M1、M2、M2 Pro/Max 等)。Rosetta 2 を介したエミュレーションは不要です。
メモリ・ディスク 推奨最低 8 GB RAM、空き容量 4 GB 以上の SSD。

ポイント:Apple Silicon は ARM64 アーキテクチャなので、Intel 用バイナリ(x86_64)を混在させると起動エラーやパフォーマンス低下が発生します。


2. Docker Desktop の公式ダウンロード

  1. ブラウザで Docker Desktop ダウンロードページ にアクセス
    https://www.docker.com/products/docker-desktop(リンクは省略)
  2. Mac with Apple chip」のボタンをクリック → Docker Desktop 4.31.0 Apple Silicon.dmg がダウンロードされます。

※ バージョン番号はページ上部に表示されています。


3. SHA‑256 チェックサムでファイルの完全性を確認

公式サイトの「SHA‑256」欄に記載されたハッシュ値と、ローカルで算出したハッシュが一致すれば改ざんや破損はありません。

重要:空文字列のハッシュ (e3b0c442…) はダミーです。必ず公式サイトに掲載されている実際の値を使用してください。


4. アプリケーションへのインストール

  1. ダウンロードした .dmgダブルクリック → ボリュームがマウントされます。
  2. 表示されたウィンドウから Docker.appApplications フォルダー にドラッグ&ドロップ。
  3. インストール完了後、.dmg ファイルはゴミ箱へ移動して削除します。

5. 初回起動時のセキュリティ設定

Apple Silicon では Docker が System Extensions(仮想化用)を使用します。初回起動で以下の手順を実行してください。

  1. Launchpad または Finder から Docker を起動 → 「開発元が未確認」等の警告ダイアログが表示されます。
  2. システム設定 > セキュリティとプライバシー > 一般 タブを開く。
  3. 下部に「“Docker” の使用が許可されました」と表示されたら 「許可」 をクリック。必要なら管理者パスワードを入力し、Mac を再起動します。

6. 初回起動後の基本設定

6‑1. リソース割り当て(CPU・メモリ)

Docker Desktop > Preferences > Resources で推奨設定例は次のとおりです。実際の使用状況に合わせて調整してください。

項目 推奨設定例
CPU 4 コア(8 コア搭載 Mac の場合)
メモリ 6 GB(16 GB 搭載モデルの場合)
Swap デフォルトのまま

設定変更後は 「Apply & Restart」 をクリックして Docker を再起動します。

6‑2. Kubernetes の有効化(任意)

Preferences > Kubernetes にチェックを入れ、同様に 「Apply & Restart」。シングルノードの K8s がバックグラウンドで起動し、 kubectl version で確認できます。


7. インストール完了の検証

ターミナルで次のコマンドを実行します。

以下のようなメッセージが出ればインストールは正常です。

エラーが表示された場合は、System Extension の許可Virtualization.framework が有効か を再確認してください。


8. よくあるエラーと対処法

症状 原因 対策
「Virtualization.framework が見つかりません」 macOS の設定で仮想化がブロックされている(企業管理下など) システム設定 > セキュリティとプライバシー > プライバシー で Docker に「Developer Tools」や「Full Disk Access」を付与し、再起動
「操作が許可されていません」(DMG コピー時) 管理者権限が必要 ターミナルで sudo cp -R /Volumes/Docker/Docker.app /Applications/ を実行
「システム拡張がブロックされました」 Apple のセキュリティポリシーにより未署名拡張が無効化された システム設定 > セキュリティとプライバシー > 一般 で「Docker の使用を許可」をクリックし、再起動

詳細な議論や類似ケースは Stack Overflow の下記スレッドでも取り上げられています。
https://stackoverflow.com/questions/79817033/sudden-docker-error-about-client-api-version


9. まとめ(要点)

  • 対象環境:macOS Ventura (13) 以降 + Apple Silicon (M1/M2 系列)
  • ダウンロード:Docker Desktop の「Mac with Apple chip」版を公式ページから取得し、バージョン番号は常に最新を確認。
  • ハッシュ検証:公式サイト掲載の SHA‑256 を shasum -a 256 で算出した値と比較(空文字列ハッシュは使用しない)。
  • インストール手順:DMG を Applications にドラッグ → System Extension 許可。
  • 初期設定:CPU/メモリの最適割り当てと、必要なら Kubernetes の有効化。
  • 動作確認docker run hello‑world が成功すれば完了。
  • トラブルシューティング:仮想化フレームワーク・権限不足・システム拡張ブロックの三大エラーは、設定変更と管理者権限付与で解決できることが多い。

上記手順に沿って作業すれば、M2 搭載 Mac でも Docker Desktop を安全かつ高速に利用できます。開発・テスト環境の構築にぜひ活用してください。

スポンサードリンク

-Docker
-, , , , , ,