Setting up supervisord in Mac OS X

installing_supervisor_macosx.md

Installation

Installing Supervisor on OS X is simple:

sudo pip install supervisor

This assumes you have pip. If you don't:

curl -O http://python-distribute.org/distribute_setup.py
python distribute_setup.py
sudo easy_install pip
sudo pip install supervisor

Create the conf.d directory that you can put subprocess configuration files into:

sudo mkdir -p /usr/local/etc/supervisor/conf.d/

Test supervisord in non-daemon mode:

supervisord -n -c /usr/local/etc/supervisord.conf

Assuming you put supervisord.conf in /usr/local/etc/ then supervisord will find it automatically. Test it:

supervisord -n

Enter supervisor interactive mode:

supervisorctl

launchfile.xml

<!-- /Library/LaunchDaemons/com.agendaless.supervisord.plist -->
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>KeepAlive</key>
    <dict>
        <key>SuccessfulExit</key>
        <false/>
    </dict>
    <key>Label</key>
    <string>com.agendaless.supervisord</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/supervisord</string>
        <string>-n</string>
        <string>-c</string>
        <string>/usr/local/share/supervisor/supervisord.conf</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
</dict>
</plist>

supervisord.conf

# /usr/local/etc/supervisord.conf
[unix_http_server]
file=/usr/local/var/run/supervisor.sock   ; (the path to the socket file)
chmod = 0770
chown = root

[supervisord]
logfile = /usr/local/var/log/supervisord.log
pidfile = /usr/local/var/run/supervisord.pid
childlogdir = /tmp

[rpcinterface:supervisor]
supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface

[supervisorctl]
serverurl = unix:///usr/local/var/run/supervisor.sock

[include]
files = /usr/local/etc/supervisor/conf.d/*.conf