Installing supervisor on Mac OS

Oleg Posyniak · July 16, 2019

Supervisor is powerful process manager for Unix systems. You can get a lot of advantages by using it.


brew install supervisor


  • /usr/local/etc/supervisord.ini - default configuration file.
  • /usr/local/etc/supervisor.d - directory for your custom *.ini files

or automatically on your system start

To view active configuration, run:



Manual run

supervisord -c /usr/local/etc/supervisord.ini

Run on system’s startup

brew services start supervisor

Web control panel

To be able to monitor and manage your processes via browser, you’ll have to open /usr/local/etc/supervisord.ini and modify these lines:

[inet_http_server]         ; inet (TCP) server disabled by default
port=        ; ip_address:port specifier, *:port for all iface
username=user              ; default is no username (open server)
password=1234              ; default is no password (open server)

Typical errors

unix:///usr/local/var/run/supervisor.sock no such file

To fix this error, kill the running process:

ps -ef | grep supervisor
pkill -f supervisord


Twitter, Facebook