PM2 command not foundの解決方法【2025年最新版】

エラーの概要・症状
このエラーが発生する原因
解決方法1（最も効果的）
解決方法2（代替手段）
解決方法3（上級者向け）
エラーの予防方法
関連するエラーと対処法
まとめ

エラーの概要・症状

PM2はNode.jsのプロセスマネージャであり、アプリケーションのデーモン化やクラスタリングを行うために使われます。しかし、コマンドラインでpm2と入力した際に「command not found」というエラーメッセージが表示されることがあります。このエラーは、PM2がインストールされていないか、パスに含まれていないことを示しています。

このエラーが発生すると、以下のような症状が現れます：
– pm2 startやpm2 listなどのコマンドを実行できない。
– アプリケーションの監視や管理ができず、デプロイメントが困難になる。
– 特にプロダクション環境において、アプリケーションの安定性に影響を与える可能性があるため、迅速な対処が求められます。これにより、開発者はエラーの解決に多くの時間を費やすことになり、業務に支障をきたす恐れがあります。

このエラーが発生する原因

PM2の「command not found」エラーの主な原因は、以下のとおりです：
1. 未インストール：PM2がシステムにインストールされていない場合、当然ながらコマンドは認識されません。
2. 環境変数の設定不足：PM2がインストールされていても、環境変数のPATHにそのインストールパスが含まれていない場合、コマンドは見つかりません。
3. 権限の問題：グローバルにインストールする際に、適切な権限がない場合にもこのエラーが発生することがあります。
4. Node.jsのバージョン管理：Node.jsをバージョン管理ツール（例えば、nvm）を使ってインストールしている場合、適切なバージョンがアクティブでないとPM2が見つからないことがあります。
5. インストールの不具合：インストール中にエラーが発生した場合も、PM2が正常に動作しないことがあります。

解決方法1（最も効果的）

手順1-1（PM2のインストール）

まず、PM2をインストールする必要があります。ターミナルを開いて、以下のコマンドを実行してください：

npm install -g pm2

このコマンドは、PM2をグローバルにインストールします。インストールが完了したら、次のステップに進みます。

手順1-2（環境変数の確認）

PM2が正しくインストールされたかを確認するために、以下のコマンドを入力します：

pm2 -v

バージョン番号が表示されれば、インストールは成功です。もし「command not found」と表示された場合、次に環境変数の設定を確認します。

環境変数の設定方法

インストールパスを確認します。以下のコマンドを実行してください：
bash whereis pm2
これにより、PM2のインストールパスが表示されます。
表示されたパスを~/.bashrcや~/.zshrcに追加します：
bash export PATH=$PATH:/opt/node/lib/node_modules/pm2/bin
設定を反映させるために、以下のコマンドを実行します：
bash source ~/.bashrc

注意点とトラブルシューティング

インストール後にpm2コマンドが認識されない場合、ターミナルを再起動してみてください。
権限の問題がある場合、sudoを使ってインストールすることを検討してください：
bash sudo npm install -g pm2

解決方法2（代替手段）

もしPM2が正しくインストールされていても依然として「command not found」エラーが出る場合、次の手順を試してください：
1. Node.jsのバージョン確認：nvmを使用している場合、現在のバージョンを確認し、必要なバージョンがアクティブかどうか確認します：
bash nvm ls
アクティブなバージョンが正しく設定されているか確認してください。
2. インストールの再試行：次に、PM2を再インストールします。
bash npm uninstall -g pm2 npm install -g pm2
3. パスの確認：再度whereis pm2コマンドでパスを確認し、正しいパスが環境変数に追加されているか確認します。

解決方法3（上級者向け）

上級者の方は、コマンドラインを直接操作することでより詳細な設定を行うことができます。以下の手順をお試しください：
1. PM2の起動設定を行う：特定のユーザーでPM2を設定する場合、以下のコマンドを実行します：
bash pm2 startup -u <YOUR_NON_ROOT_USER>
2. 環境変数を設定する：必要に応じて、環境変数を変更します：
bash env PATH=$PATH:/usr/bin pm2 startup systemd -u <YOUR_USER>
3. アプリケーションを起動する：PM2を使用してアプリケーションを起動します：
bash pm2 start <YOUR_PATH_TO_INDEX.JS> --name <YOUR_APPLICATION_NAME>

エラーの予防方法

PM2の「command not found」エラーを未然に防ぐために、以下のような予防策を講じることが重要です：
1. 定期的なメンテナンス：Node.jsやnpm、PM2のバージョンを定期的に確認し、更新を行うことで新たな問題を防ぎます。
2. 環境変数の確認：新たにインストールしたパッケージが正しくパスに追加されているか、確認しておくことが重要です。
3. ドキュメントの確認：PM2の公式ドキュメントを参照し、最新のインストール手順や設定方法を把握しておくことが推奨されます。

まとめ

PM2の「command not found」エラーは、主にインストールや環境変数に起因する問題であることが多いです。これらの解決方法を試すことで、エラーを解消できる可能性が高いです。正しい設定を行い、定期的にメンテナンスを行うことで、今後のトラブルを未然に防ぐことができます。PM2を活用して、アプリケーションの運用をよりスムーズに行いましょう。