前提条件
- macOS（Intel または Apple Silicon 両対応）
- 管理者権限（インストール時にパスワード入力が必要）
1. Homebrew を使ってインストールする（推奨）
インストール手順
brew install --cask docker
open /Applications/Docker.app
- 初回起動時に、権限許可（パスワード入力）が求められます。
- メニューバーに 🐳 アイコンが表示されれば起動完了です。
2. Homebrew を使わずにインストールする（公式サイト経由）
インストール手順
-
Docker公式サイト にアクセス
-
「Download for Mac (Apple chip or Intel chip)」を選択
- お使いの Mac に対応する
.dmgファイルを選んでください
- お使いの Mac に対応する
-
ダウンロードした
.dmgファイルを開く -
「Docker.app」を アプリケーションフォルダ にドラッグ＆ドロップ
-
/Applications/Docker.appを起動（または Finder からダブルクリック） -
初回起動時にアクセス許可・パスワード入力を求められます
動作確認
docker --version
docker run hello-world
docker: command not foundが出る場合、Docker Desktop が起動していない、または$PATHが通っていない可能性があります。
一度open /Applications/Docker.appで起動後、再試行してください。
トラブル時のTips
1. Docker が起動しているか確認
open /Applications/Docker.app
- メニューバーに 🐳 アイコンが表示され、「Docker is running」となっていれば OK
- 起動していない場合、コマンドや GUI 操作は無効になります
2. CLI が使えるか確認
docker --version
-
command not foundエラー →$PATHが通っていない or Docker Desktop が未起動 - 起動後でもダメな場合は、再起動 or パスの手動設定を検討
3. docker pull alpine でネットワーク＆レジストリ接続確認
Docker がインターネットおよび Docker Hub に正しくアクセスできるかを確認します。
docker pull alpine
-
成功：
Status: Downloaded newer image for alpine:latest -
失敗例：
-
unauthorized: 認証エラー → 次項を参照 -
network timeout: ネットワーク設定を確認（VPNやProxyの影響など）
-
4. 認証情報をリセット（Docker Hub 認証エラーなど）
docker logout
docker login
-
docker logout：既存のログインセッションを終了 -
docker login：Docker Hub アカウントで再ログイン（またはトークン使用）
pullやpushの際に 401 エラーなどが出る場合に有効
5. キャッシュや不要なリソースを削除して環境をリセット
docker system prune -a
- 未使用のイメージ・コンテナ・ネットワーク・ボリュームを一括削除
- ストレージ節約や、古いイメージの影響を取り除きたいときに有効
⚠️ すべての未使用リソースが消えるので、事前に確認しましょう！
6. Docker Desktop を再起動／再インストール
-
Docker.appを終了し、再起動 - 起動しない・挙動が不安定な場合は、アンインストールして再インストール
補足：トラブル対応チェックリスト
| チェック項目 | 確認方法 | 解決手段 |
|---|---|---|
| Docker が起動しているか | メニューバーの 🐳 | open /Applications/Docker.app |
| CLI が使えるか | docker --version |
$PATH 確認 or 起動確認 |
| レジストリ接続確認 | docker pull alpine |
認証・ネットワーク確認 |
| 認証エラー |
unauthorized, 403
|
docker logout → login
|
| ストレージ肥大 |
docker images, docker ps -a
|
docker system prune -a |