Supervisors is a system that monitors and controls process state on UNIX-like operating systems. It watches processes and restart them in the case of failure. Also it makes sure that the processes start on system boot. For more information read Supervisor: A Process Control System.

When you have long running scripts (e.g. RabbitMQ, Beanstalkd etc.), you want to make sure that they really are always running. However, we also know that for any given reason at any time, scripts and systems fail. In such cases, the scripts should restart automatically without human interaction so we can use supervisor process watcher to do it for us.


$ sudo apt-get install supervisor

--- Version
$ supervisord -v


For more details, please visit Running Supervisor and Running Supervisorctl pages.

$ sudo service supervisor {start|stop|restart|force-reload|status|force-stop}

$ sudo supervisorctl # Lists all processes and lets you use internal commands


The location to the main log file is /var/log/supervisor/supervisord.log. This will be different to your custom service/script log files.


Location to the configuration file is /etc/supervisor/supervisord.conf. If you print its content, you'll see section below at the end of the file.

files = /etc/supervisor/conf.d/*.conf

This means, any files with extension *.conf under /etc/supervisor/conf.d/ directory will be included and run by supervisord. When you create a configuration file for your service/script, you will put it there. E.g. /etc/supervisor/conf.d/hello-world.conf

Configuration Options

For more details, please visit Configuration page.

You must always use -DFOREGROUND flag and startsecs=0 option. They are needed to prevent supervisor crashing with errors. Such as # INFO gave up: ... entered FATAL state, too many start retries too quickly or Exited too quickly (process log may have details).

Loading configuration files

If you created a new config file for your service/script, you must use commands below to activate them by notifying supervisor.

$ sudo supervisorctl reread
$ sudo supervisorctl update

Listing processes and internal commands

For more information, please visit Running Supervisorctl page.

$ sudo supervisorctl

Use help flag to list all available commands.

supervisor> help

default commands (type help ):
add clear fg open quit remove restart start stop update
avail exit maintail pid reload reread shutdown status tail version

Web Interface

Open sudo nano /etc/supervisor/supervisord.conf to add lines below into it.

port = 9001
username = admin
password = admin

Restart supervisor.

$ sudo service supervisor restart

Visit to access web interface.