macOSでDockerを起動してもコマンドを実行できないときの対処法

dockerコマンドが実行できないときの対処法

macOSでDockerを起動するには

  1. Docker公式サイトから、Docker Desktop for Macをダウンロードする。
  2. ダウンロードしたインストーラ (.dmg ファイル) を開いてインストールする。
  3. Dockerアプリを起動する。

通常は以上の3ステップが完了すれば「docker --version」などのコマンドが実行できます。

しかし、環境によってはDockerを起動していても、以下のように「zsh: command not found: docker」と表示されて実行できないことがあります。

$ docker --version
zsh: command not found: docker

原因は不明ですが、.zshrcにシンボリックリンクへのパスが追加されないことがあります。

そんなときはcodeコマンドなど.zshrcファイルを開いて、PATHを追記します。

$ code ~/.zshrc
.zshrc
# 中略

export PATH="/Applications/Docker.app/Contents/Resources/bin:$PATH"

.zshrcにPATHを追記したら、source ~/.zshrc で読み込んでください。

これらの設定が完了すればdockerコマンドが使用可能になります。

$ code ~/.zshrc

docker --version
docker run hello-world

私の周りのフロントエンドエンジニアでこの現象が発生するフロントエンドエンジニアの方がたまにいるのですが、対処法があまり知られていないので記事を投稿しました。