LinuxCommandLibrary

supervisorctl

Control Supervisor managed processes

TLDR

Show status

$ supervisorctl status
copy
Start process
$ supervisorctl start [process_name]
copy
Stop process
$ supervisorctl stop [process_name]
copy
Restart process
$ supervisorctl restart [process_name]
copy
Reload configuration
$ supervisorctl reread && supervisorctl update
copy
Start all processes
$ supervisorctl start all
copy
Tail process log
$ supervisorctl tail -f [process_name]
copy
Interactive shell
$ supervisorctl
copy

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.
-c FILE
Config file.

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

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community