supervisord

supervisord [-c config] [-n] [-e level] [options]

supervisord is a process control daemon that manages long-running processes, automatically restarting them if they crash or exit unexpectedly. It is widely used to run application servers, background workers, and other services that need reliable process supervision.The configuration file defines programs with their commands, environment variables, user permissions, and restart policies. Programs can be organized into groups for coordinated management. The daemon captures stdout and stderr from managed processes, writing them to log files with configurable rotation.Event listeners allow custom scripts to respond to process state changes such as crashes or transitions. The daemon communicates with supervisorctl through a Unix socket or TCP connection, and provides an optional web interface for process management.

-c FILE

Configuration file.

Run in foreground.

Log level.

Test configuration.

Working directory.

Run as user.

Pidfile path.

/etc/supervisor/supervisord.conf

Main configuration file defining programs, groups, logging, and socket settings.

Drop-in directory for individual program configuration files.

Not a replacement for init systems. Single point of failure. Needs its own monitoring.

Supervisor was created by Chris McDonough (Agendaless Consulting). It provides simple process management for Python applications and beyond.

supervisorctl(1)