Contents
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 の公式ダウンロード
- ブラウザで Docker Desktop ダウンロードページ にアクセス
https://www.docker.com/products/docker-desktop(リンクは省略) - 「Mac with Apple chip」のボタンをクリック →
Docker Desktop 4.31.0 Apple Silicon.dmgがダウンロードされます。
※ バージョン番号はページ上部に表示されています。
3. SHA‑256 チェックサムでファイルの完全性を確認
公式サイトの「SHA‑256」欄に記載されたハッシュ値と、ローカルで算出したハッシュが一致すれば改ざんや破損はありません。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
# ダウンロード先へ移動 cd ~/Downloads # 公式ページから取得したハッシュを変数に格納(例として <HASH> を使用) EXPECTED="<SHA256_HASH_FROM_OFFICIAL_SITE>" # 実際のハッシュを計算 CALCULATED=$(shasum -a 256 "Docker Desktop 4.31.0 Apple Silicon.dmg" | awk '{print $1}') if [ "$EXPECTED" = "$CALCULATED" ]; then echo "✅ ハッシュが一致しました。インストールを続行できます。" else echo "⚠️ ハッシュが一致しません! ダウンロードをやり直してください。" fi |
重要:空文字列のハッシュ (
e3b0c442…) はダミーです。必ず公式サイトに掲載されている実際の値を使用してください。
4. アプリケーションへのインストール
- ダウンロードした
.dmgを ダブルクリック → ボリュームがマウントされます。 - 表示されたウィンドウから Docker.app を Applications フォルダー にドラッグ&ドロップ。
- インストール完了後、
.dmgファイルはゴミ箱へ移動して削除します。
5. 初回起動時のセキュリティ設定
Apple Silicon では Docker が System Extensions(仮想化用)を使用します。初回起動で以下の手順を実行してください。
- Launchpad または Finder から Docker を起動 → 「開発元が未確認」等の警告ダイアログが表示されます。
- システム設定 > セキュリティとプライバシー > 一般 タブを開く。
- 下部に「“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. インストール完了の検証
ターミナルで次のコマンドを実行します。
|
1 2 |
docker run --rm hello-world |
以下のようなメッセージが出ればインストールは正常です。
|
1 2 3 4 |
Hello from Docker! This message shows that your installation appears to be working correctly. ... |
エラーが表示された場合は、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 を安全かつ高速に利用できます。開発・テスト環境の構築にぜひ活用してください。