Configuration File

The Supervisor configuration file is conventionally namedsupervisord.conf. It is used by both supervisordand supervisorctl. If either application is startedwithout the -c option (the option which is used to tell theapplication the configuration filename explicitly), the applicationwill look for a file named supervisord.conf within thefollowing locations, in the specified order. It will use the firstfile it finds.

  • $CWD/supervisord.conf
  • $CWD/etc/supervisord.conf
  • /etc/supervisord.conf
  • /etc/supervisor/supervisord.conf (since Supervisor 3.3.0)
  • ../etc/supervisord.conf (Relative to the executable)
  • ../supervisord.conf (Relative to the executable)

Note

Many versions of Supervisor packaged for Debian and Ubuntu included a patchthat added /etc/supervisor/supervisord.conf to the search paths. Thefirst PyPI package of Supervisor to include it was Supervisor 3.3.0.