Contents
1️⃣ Docker Desktop と macOS の対応状況(2026 年時点)
| macOS バージョン | 対応状況 (Docker Desktop 4.27) | 参考リンク |
|---|---|---|
| Ventura (13.x) | ✅ 完全サポート ※Apple Silicon と Intel の両方で動作 |
【1】 |
| Sonoma (14.x) | ✅ 完全サポート(2024 年 10 月リリース以降の Docker Desktop にて確認) | 【1】 |
| Sequoia (15.x) | ⚠️ 現在ベータ版対応中。公式は「macOS 15 のプレビュー環境で動作検証済み」と表記【2】 | 【2】 |
ポイント
- Docker Desktop は macOS のメジャーリリースごとにサポート情報を更新します。新しい OS が一般提供されるたびに、対応版がリリースノートで明示されます。
- 「ベータ版対応」=Apple のプレビューリリース上で動作は確認できても、正式リリース前の安定性は保証されません。プロダクション環境で利用する場合は、公式が「GA(General Availability)」と明記したバージョンを選択してください。
情報取得のベストプラクティス
- Docker Desktop の Release Notes ページを定期的に確認(https://docs.docker.com/desktop/mac/release-notes/)
- macOS のリリースノートと併せて、Apple が提供する「macOS Compatibility」情報もチェック
- Homebrew Cask のバージョン表記(
brew info --cask docker)でインストール可能な最新ビルドを把握
2️⃣ ハードウェア別システム要件と仮想化基盤
| 項目 | Apple Silicon (M1/M2/M3 系列) | Intel Mac |
|---|---|---|
| CPU アーキテクチャ | ARM64(Apple Silicon) | x86_64 |
| 必須 macOS バージョン | Ventura 13.0 以上 | Ventura 13.0 以上 |
| 仮想化フレームワーク | Virtualization.framework(macOS 標準搭載)【3】 |
Hypervisor.framework(標準搭載) |
| Rosetta 2 の必要性 | Intel 用コンテナや旧バイナリを実行する場合のみインストール推奨 | 不要 |
| 最低メモリ | 8 GB(推奨 16 GB) | 同上 |
| ディスク空き容量 | 4 GB 以上の空き領域(Docker イメージ・ボリューム用に追加確保が望ましい) | 同上 |
補足
- Apple Silicon の利点:
Virtualization.frameworkはハードウェアアクセラレーションと低レイテンシを提供し、Intel ベースの HyperKit に比べて起動が速くなります。 - Rosetta 2 が必要になるケースは「x86_64 用 Docker イメージ(例:特定の Windows 向けツールチェーン)をそのまま実行」する場合に限られます。通常の Linux コンテナはすべて ARM に変換され、Rosetta は介在しません。
3️⃣ インストール手順比較 – 公式 DMG vs Homebrew Cask
3.1 公式サイトからの手動インストール(DMG)
| 手順 | コマンド・操作 |
|---|---|
| ① ダウンロード | Docker Desktop の macOS 用ページ(https://www.docker.com/products/docker-desktop)から Docker.dmg を取得。自動的に Apple Silicon と Intel 用バイナリが同梱されます。 |
| ② マウント | bash<br>hdiutil attach Docker.dmg<br> |
| ③ インストール実行 | bash<br>/Volumes/Docker/Docker.app/Contents/MacOS/install<br>(管理者権限が必要) |
| ④ アプリ配置 | インストーラが自動で /Applications/Docker.app にコピーします。 |
| ⑤ Gatekeeper 許可 | 初回起動時に「未確認の開発元」警告が出たら、System Settings → Privacy & Security → Allow apps downloaded from identified developers で例外許可を行います。 |
メリット
- ダウンロードしたバイナリの Notarization ステータス を直接確認できる(Finder の情報パネルに表示)。
- カスタムインストールや、企業内部ネットワークでプロキシ経由ダウンロードが必要なケースに柔軟に対応可能。
デメリット
- 手動操作が増えるため、スクリプト化や大量展開には向かない。
- アップデートは都度公式サイトから再取得する必要があります。
3.2 Homebrew Cask を利用したインストール
|
1 2 3 4 5 6 |
# Homebrew が未導入の場合(macOS 標準の /opt/homebrew にインストール) /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # Docker Desktop の Cask をインストール brew install --cask docker |
| 特徴 | 内容 |
|---|---|
| 自動配置 | インストーラは /Applications/Docker.app に直接配置。手動ドラッグ不要。 |
| アップデート管理 | brew upgrade --cask docker で最新バージョンへ一括更新可能。brew autoupdate プラグインを導入すれば自動実行も設定できる【4】。 |
| 依存関係の解決 | Homebrew が必要なシステムツール(例:gpg, coreutils)を自動でインストールします。 |
メリット
- コマンド一発で導入・更新が完了し、CI/CD パイプラインや構成管理ツール(Ansible, Chef 等)と組み合わせやすい。
- Homebrew の Caskroom が公式リポジトリと同期しているため、バージョン情報の遅延はほぼなし。
デメリット
- 社内ネットワークで外部リポジトリへのアクセスが制限されている場合、プロキシ設定やミラーサーバ構築が必要になる。
- Homebrew の管理下に置くことで、独自のパッチ適用やカスタムインストーラを使用したいケースには不向き。
4️⃣ 初回起動時に行うべき権限設定と基本リソース構成
4.1 必要なシステム権限
| 権限 | 設定手順 | 推奨レベル |
|---|---|---|
| Full Disk Access(フルディスクアクセス) | System Settings → Privacy & Security → Full Disk Access → “Docker Desktop” にチェック | ✅ 必須(ボリュームマウントやファイル共有に必要) |
| Network(ネットワーク) | 同上 → Network の自動許可はデフォルトで有効。企業環境ではプロキシ設定が別途必要になることがあります。 | ✅ 推奨 |
| Virtualization(仮想化の実行権限) | System Settings → Privacy & Security → Developer Tools → “Enable Virtualization” にチェック | ✅ 必須 |
| Rosetta 2(Apple Silicon のみ) | Terminal: softwareupdate --install-rosetta (Intel コンテナを使用する場合のみ) |
⚠️ 必要時だけ |
Tip:権限付与後は Docker Desktop を再起動すると、設定が即座に反映されます。
4.2 リソース割り当て(Preferences → Resources)
| 項目 | デフォルト値 | 推奨上限 |
|---|---|---|
| CPU | 2 cores | システム全体の 50 % 未満(例:8 core Mac なら最大 4 cores) |
| Memory | 4 GB | 合計メモリの 25 %〜30 %(16 GB 搭載機種は 6‑8 GB が目安) |
| Disk image size | 20 GB | 必要に応じて拡張(Preferences → Resources → Disk Image Size) |
| Swap | 無効(デフォルト) | 大規模ビルドやメモリ負荷が高いワークロードは有効化検討 |
4.3 Kubernetes の有効化
Docker Desktop > Preferences > Kubernetesに移動- “Enable Kubernetes” をオンにし、Apply & Restart をクリック
- 起動完了まで数分待機 →
kubectl versionでクライアント/サーバーバージョンを確認
注意:ローカル K8s は開発・テスト用途に限定し、本番環境では外部クラスタ(EKS, GKE, AKS 等)へデプロイしてください。
5️⃣ 動作確認と代表的なトラブルシューティング
5️⃣1 基本的なインストール検証コマンド
|
1 2 3 4 5 6 |
# Docker クライアント・サーバーのバージョン情報取得 docker version # 簡易テストコンテナ(hello-world)の実行 docker run --rm hello-world |
期待される出力例
|
1 2 3 4 5 6 7 8 9 10 11 12 |
Client: Docker Engine - Community Version: 24.0.7 API version: 1.44 ... Server: Docker Desktop 4.27.x (2026‑04) Engine: Version: 24.0.7 API version: 1.44 ... Hello from Docker! |
出力が上記のように表示されれば、Docker Daemon とネットワーク設定は正常です。
5️⃣2 よくあるエラーメッセージと対処法
| エラー | 主な原因 | 解決策 |
|---|---|---|
Rosetta is required |
Apple Silicon で Intel 用バイナリが呼び出された | ターミナルで softwareupdate --install-rosetta を実行し、再起動後に Docker Desktop を再起動 |
Virtualization.framework is not enabled |
macOS のシステム設定で仮想化が無効化されている | System Settings → Privacy & Security → Developer Tools で “Enable Virtualization” にチェック |
Docker daemon failed to start (Intel) |
HyperKit が署名されていない/Gatekeeper にブロックされた | Docker.app を右クリック → “Open” で手動許可し、再起動 |
client API version is too old |
CLI と Daemon のバージョン不整合(古い docker CLI) | Homebrew で最新 Cask を取得 brew upgrade --cask docker、または公式サイトから最新版を再インストール |
Cannot connect to the Docker daemon at unix:///var/run/docker.sock |
権限不足(Docker グループ未所属) | macOS では通常不要だが、ターミナルで sudo chown $USER:staff /var/run/docker.sock を試すか、Full Disk Access の付与を再確認 |
6️⃣ アップデートとメンテナンスのベストプラクティス
6️⃣1 手動アップデート(公式 UI)
- Docker Desktop メニュー → Check for Updates
- 新バージョンが利用可能な場合はダウンロード・インストールが自動で開始。
- インストール完了後は Restart Docker Desktop が求められます。
ポイント:アップデート前に稼働中コンテナを
docker compose downなどで停止し、重要なイメージはdocker saveでエクスポートしておくと安全です。
6️⃣2 Homebrew 経由の自動更新
|
1 2 3 |
# 定期的に実行(例:cron または launchd) brew upgrade --cask docker |
- 自動化:
brew autoupdate --start --upgrade --cleanupをデーモンとして登録すれば、毎日自動で最新 Cask が取得されます【4】。 - バージョン固定:CI 環境や社内標準化が必要な場合は
brew install --cask docker@4.27のように特定バージョンを指定可能です(Cask が提供している限り)。
6️⃣3 アップデート時の安全策
| 作業 | 推奨手順 |
|---|---|
| バックアップ | docker save $(docker images -q) > all_images.tar でローカルイメージをエクスポート。 |
| 設定保存 | Preferences → “Export Settings”(JSON)で現在のリソース割り当てや Kubernetes 設定を保存。 |
| ロールバック | Homebrew の場合 brew reinstall --cask docker@4.27、公式 UI では「Previous version」リンクから過去版インストーラを取得【1】。 |
7️⃣ まとめ
- Docker Desktop は macOS Ventura/14 Sonoma を完全にサポートし、Sequoia (15) のベータ環境でも動作確認が取れています(正式対応は次バージョンで期待)。
- Apple Silicon と Intel では仮想化フレームワークが異なるため、システム要件・Rosetta の有無に注意が必要です。
- インストールは 公式 DMG と Homebrew Cask の二通りがあり、手動管理が好みなら DMG、スクリプト化や自動更新を重視するなら Homebrew が最適です。
- 初回起動時に Full Disk Access, Virtualization, Network などの権限付与と、CPU/メモリの適切な割り当てを行えば、すぐに開発環境として利用できます。
docker versionとdocker run hello-worldが成功すればインストール完了です。エラーは主に仮想化設定や Rosetta の欠如が原因となりますので、本稿の対処表を参照してください。- アップデートは 公式 UI または Homebrew Cask を活用し、事前にイメージ・設定バックアップを取ることで安全に運用できます。
参考リンク
- Docker Desktop for Mac – Release Notes: https://docs.docker.com/desktop/mac/release-notes/
- Docker Desktop on macOS 15 (Sequoia) – Preview Support: https://docs.docker.com/desktop/mac/sequoia-preview/
- Apple Developer – Virtualization.framework Overview: https://developer.apple.com/documentation/virtualization
- Homebrew Cask – docker: https://formulae.brew.sh/cask/docker