snippetbashTip

supervisorctl — Supervisor, a client/server system that allows its users to control a number of processes on UNIX-li

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

servercommandclientsupervisorctlclithatsupervisorsystem

Problem

How to use the supervisorctl command: Supervisor, a client/server system that allows its users to control a number of processes on UNIX-like operating systems. Supervisorctl is the command-line client piece of the supervisor which provides a shell-like interface. More information: <https://supervisord.org/running.html#running-supervisorctl>.

Solution

supervisorctl — Supervisor, a client/server system that allows its users to control a number of processes on UNIX-like operating systems. Supervisorctl is the command-line client piece of the supervisor which provides a shell-like interface. More information: <https://supervisord.org/running.html#running-supervisorctl>.

Show the status of a process (or all processes if process_name is not specified):

supervisorctl status {{process_name}}

Start/stop/restart a process:

supervisorctl {{start|stop|restart}} {{process_name}}

Start/stop/restart all processes in a group:

supervisorctl {{start|stop|restart}} {{group_name}}:*

Show last 100 bytes of process stderr:

supervisorctl tail -100 {{process_name}} stderr

Keep displaying stdout of a process:

supervisorctl tail -f {{process_name}} stdout

Reload process configuration file to add/remove processes as necessary:

supervisorctl update

Code Snippets

Show the status of a process (or all processes if `process_name` is not specified)

supervisorctl status {{process_name}}

Start/stop/restart a process

supervisorctl {{start|stop|restart}} {{process_name}}

Start/stop/restart all processes in a group

supervisorctl {{start|stop|restart}} {{group_name}}:*

Show last 100 bytes of process `stderr`

supervisorctl tail -100 {{process_name}} stderr

Keep displaying `stdout` of a process

supervisorctl tail -f {{process_name}} stdout

Context

tldr-pages: common/supervisorctl

Revisions (0)

No revisions yet.