block by jczaplew bf3a33c5a82a2d93bba4

Setting up a LaunchDaemon with pm2

Setting up a LaunchDaemon with pm2

If you have a Node.js app running on an OS X server, you probably:

While pm2 has the ability to generate startup scripts for use with Ubunutu, Centos, and systemd, it does not work with OS X. The best approach is to use launchd, an OS X-specific daemon manager that replaces cron. It uses XML-based files for configuration. This guide will walk you through the process. Note: “xyz” is used as a placeholder for the application name throughout this guide.


  1. Create a new LaunchDaemon config file for your app - sudo vi /Library/LaunchDaemons/
  2. Add the contents of, altering it with your configuration, and save (:wq) and exit
  3. sudo chown root:wheel /Library/LaunchDaemons/
  4. sudo chmod 644 /Library/LaunchDaemons/
  5. Find your path by typing echo $PATH
  6. sudo vi /etc/launchd.conf
  7. Add the contents of launchd.conf, but use whatever $PATH you just echoed, then save and exit
  8. sudo shutdown -r now - this will reboot the system. If you skip this step, the changes to launchd.conf will not take effect.
  9. Log back into the machine
  10. sudo launchctl load /Library/LaunchDaemons/
  11. Verify that it loaded correctly - sudo launchctl list | grep xyz. Three columns will be returned - PID, status, and label. If there is no value for PID, but there is a value for status, something went wrong.
  12. If everything went according to plan, you should now be able to pm2 list and see your Node app running. If you get an error, you might need to sudo chmod 777 /Users/<<me>>/.pm2/pm2.log.