supervisorctl
Control Supervisor managed processes
TLDR
SYNOPSIS
supervisorctl [options] command [args]
DESCRIPTION
supervisorctl is the command-line client for controlling processes managed by the supervisord daemon. It provides commands to start, stop, restart, and monitor long-running processes, as well as view their status and log output.The status command displays all managed processes with their state (RUNNING, STOPPED, FATAL), PID, and uptime. Individual processes or process groups can be controlled independently. The reread command detects configuration file changes, and update applies those changes without restarting unaffected processes.The tool can operate in single-command mode or as an interactive shell with tab completion. The tail command streams process stdout/stderr output in real time, useful for debugging application issues. Configuration changes typically follow a reread-then-update workflow to safely apply modifications.
PARAMETERS
status
Show process status.start NAME
Start process.stop NAME
Stop process.restart NAME
Restart process.reread
Reload config files.update
Apply config changes.tail NAME
Show process output. Use -f to follow, stderr suffix for stderr stream.pid NAME
Display PID of the process.signal SIG NAME
Send a signal (e.g. HUP, TERM) to the process.clear NAME
Clear the process log files.-c FILE
Path to the supervisord configuration file.-s URL
Supervisor server URL (e.g. unix:///path or http://host:port).-u USER / -p PASSWORD
Username and password for server authentication.
CAVEATS
Requires supervisord running. Socket permissions may be needed. Config changes need update.
HISTORY
Supervisor was created by Chris McDonough for process management. It's widely used for running application servers and background workers.
SEE ALSO
supervisord(8), systemctl(1)
