October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix NowOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
VGSources
Blog

How to Install and Manage Supervisor on Ubuntu and Debian

A practical Ubuntu and Debian guide to installing Supervisor, writing per-application configurations, applying changes safely, managing processes, securing the optional HTTP interface, and diagnosing programs that will not start.
Length9 min Posted Quest giverVGSources Team

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

On Ubuntu or Debian, the most predictable way to install Supervisor is the distribution package: run sudo apt-get update, then sudo apt-get install supervisor. The package registers supervisor.service with systemd. You define each application in a separate [program:name] section under /etc/supervisor/conf.d/, then make Supervisor notice changes with sudo supervisorctl reread followed by sudo supervisorctl update. Use sudo supervisorctl status for process state and inspect /var/log/supervisor/ when something fails.

What Supervisor is and where it fits

Supervisor is a client/server process-control system for UNIX-like operating systems. The long-running server, supervisord, starts configured child programs, watches them, restarts them after crashes, and records their standard output and standard error. The command-line client, supervisorctl, sends control commands to that daemon.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

This arrangement is useful for a web worker, queue consumer, game server helper, or other foreground process that must stay running without a human terminal. Supervisor is not the application itself: it launches the command you specify, applies the selected user and working directory, and manages its lifecycle and logs.

Install Supervisor from Ubuntu or Debian repositories

Update package metadata and install

  1. Log in with an account allowed to use sudo.
  2. Refresh the local package index:
sudo apt-get update
  1. Install the package:
sudo apt-get install supervisor

The apt package supplies the daemon, the control client, the default configuration layout, and a systemd unit. On Ubuntu 24.04 the unit is named supervisor.service and is described as “Supervisor process control system for UNIX.”

#1 Best Overall
Sale
Gaoye Blue Light Blocking Glasses
  • BLUE LIGHT BLOCKING GLASSES: Our blue light glasses for women boast UV400 protection, blocking harmful blue rays from computer screens. With these bluelight glasses women, you can enjoy gaming, reading, or watching TV with no worries of eye strain.
  • EYE RELIEF: Our blue light glasses are engineered to reduce blurry vision or strain caused by prolonged screen time. These womens blue light glasses aid in better sleep by preventing blue light from disrupting your natural sleep cycle, helping you fall asleep faster and enjoy a more restful night's sleep, making them the perfect christmas present.
  • COMFORTABLE: Crafted from durable material, our trendy blue light glasses for woman or blue light glasses men ensure long-lasting comfort. The high-transmittance lenses accessories, gamer gifts for men, help keep your eyes relaxed. Perfect stocking stuffers, gifts for gamers men, christmas gifts for men, halloween costumes.
  • LIGHTWEIGHT: These clear blue light glasses feature a lightweight frame, meaning they’ll stay comfy for long-term wear. Perfect as blue blockers glasses for women or mens blue light glasses, these non-prescription fake glasses for men can be worn throughout the day. The blue light blocking glasses women feature polycarbonate HD lenses, which are anti-reflective and restore true color.
  • WORRY-FREE PURCHASE: If you experience any issues, our support team is ready to assist you quickly. These are the perfect costume glasses for cosplay dressing up.

Confirm that the service is available

sudo systemctl status supervisor

A running service means systemd has started supervisord. If the service is inactive or failed, the status output normally includes the immediate reason; the daemon log at /var/log/supervisor/supervisord.log provides the next level of detail.

To have systemd start Supervisor automatically on boot, enable the unit and start it immediately:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
sudo systemctl enable --now supervisor

If your distribution has already enabled the unit during package installation, this command simply confirms that setting. Check the result with systemctl is-enabled supervisor and systemctl is-active supervisor.

Check the installed version

supervisord -v

Upstream documentation currently describes Supervisor 4.3.0, but Ubuntu and Debian repositories can ship an older release. Always use the version printed on your machine when interpreting option availability or behavior.

APT package or pip installation?

Both installation styles exist, but they have different operational consequences. For a conventional Ubuntu or Debian server, apt is generally the lower-effort choice because it follows the distribution’s systemd and filesystem conventions.

Consideration APT package pip installation
Install command sudo apt-get update followed by sudo apt-get install supervisor Install the Python package yourself; the exact command and environment depend on your Python and virtual-environment policy
Service integration Provides the distribution’s supervisor.service systemd integration You must create and maintain your own service integration
Configuration conventions Uses /etc/supervisor/supervisord.conf and the included /etc/supervisor/conf.d/ directory You must choose and maintain the configuration location and include layout
Upgrades Managed with the operating system’s package updates; repository versions may lag upstream Managed independently of apt; you are responsible for the Python environment and service files
Best fit Most Ubuntu and Debian VPS or servers that want standard system administration Environments that deliberately need an independently managed Python package and are prepared to own the additional service setup

Do not mix a pip-managed daemon with an apt-managed service unless you intentionally understand which executable and configuration file systemd will launch. Two installations can leave you troubleshooting the wrong binary or the wrong configuration tree.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Windex Gaming Cleaning Wipes, Pre-Moistened Wipes to Instantly Clean all Gaming Gear and Electronics, Resealable Packaging for a Freshness Lock, 25 count (Pack of 1)
  • WINDEX GAMING WIPES: effortlessly clean all your gaming gear and gaming electronics in one easy step with our new Windex Gaming Wipes
  • AMMONIA FREE: our ammonia-free formula is safe to use on all of your favorite gaming equipment like consoles, headsets, controllers, screens, keyboards, and more
  • PRE-MOISTENED WIPES: each wipe instantly removes dust, dirt, and stubborn smudges and fingerprints leaving a streak-free shine
  • ANTI-STATIC: great for cleaning and wiping down your gaming gear and electronics leaving behind no visible residue
  • COMPACT RESEALABLE PACKAGE: store your pack of Windex Gaming Wipes anywhere in your home for whenever a quick and easy wipedown is needed

Understand the Supervisor configuration layout

The main file and included directory

The conventional main file is /etc/supervisor/supervisord.conf. It includes every file ending in .conf in /etc/supervisor/conf.d/. Keep one application per file so that a change is easy to review and reload.

/etc/supervisor/supervisord.conf
/etc/supervisor/conf.d/myapp.conf
/var/log/supervisor/supervisord.log

A file in conf.d is not automatically applied as soon as it is saved. Supervisor reads the directory when told to do so; the reload procedure is covered below.

Create a program definition

Create a file such as /etc/supervisor/conf.d/myapp.conf with a section named for the program:

[program:myapp]
command=/usr/bin/python3 /srv/myapp/app.py
directory=/srv/myapp
user=www-data
autorestart=unexpected
stdout_logfile=/var/log/myapp/out.log
stderr_logfile=/var/log/myapp/err.log

Change every example value to match your server. In this example, Supervisor starts Python with an absolute interpreter path, changes to /srv/myapp before launching, drops privileges to www-data, and writes the child process’s output streams to the two specified files.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What the important options do

  • command is the complete foreground command Supervisor launches. Use absolute paths when possible so the service does not depend on an interactive shell’s environment.
  • directory sets the working directory before the command starts. Relative file paths used by the application are interpreted from this directory.
  • user runs the child as a named account instead of leaving it at the daemon’s privilege level. The account must be able to read the application and write any files or logs the command needs.
  • autorestart=unexpected asks Supervisor to restart the process when it exits unexpectedly, while not treating a clean, expected exit as a crash.
  • stdout_logfile and stderr_logfile direct the child’s standard output and error streams to explicit files. Create the parent directory and set permissions that allow the configured account to write there.

Use a unique name after program:. That name is the handle used by supervisorctl start, stop, and restart.

Apply a new or edited configuration correctly

Supervisor does not watch conf.d continuously. After adding or changing a program file, always perform these two operations in order:

Rank #3
Sale
LISEN Cell Phone Stand Phone Holder for Desk, Office Decor Gadgets for Men
  • Ergonomic & Adjustable Design: Fight "text neck" and improve your posture. Designed for comfort, it offers an adjustable height (7.1in-8.5in) (1.4in adjustable range) and angle (5°-85°) Please note: cell phone stand is only 9 inches tall—the length of a standard pencil
  • Without blocking subtitles Perfect for office desk Tiktok Face Time Zoom video—this is the ultimate kitchen desk essential for phones! Perfect viewing experience while reducing neck back strain, A must-have for gamers streamers desk, and anyone who values both style and support!
  • Sleek & Stable Design fits Otterbox Case: Say goodbye to bent cables, tangles, and tip-overs! LISEN’s stylish adjustable desk phone holder features a built-in charging hole and smart cable management, keeping your phone secure and your workspace clutter-free cool gadgets for men
  • ANTI-SLIP DESIGN free hands: The under 10.00 items easy gadgets back and the bottom of this kitchen essentials for women are fully covered by anti-skid silicone, which LISEN stand up desk decor can provide maximum protection device from any scratches and slides
  • Your Perfect Viewing Companion:If your product arrives damaged or breaks within 365 days, reach out to LISEN for a quick and hassle-free solution. Struggling with assembly, like tightening the screw? We’ve got your back! Your experience matters to us. (Product including: phone Holder stand*1, screw*1, hexagon screwdriver*1, specification*1)
  1. Ask the daemon to scan the configuration files:
sudo supervisorctl reread
  1. Apply the changes it reported:
sudo supervisorctl update
Command Effect What it does not do
reread Reports which program definitions were added, changed, or removed after scanning the files Does not start or stop those programs by itself
update Starts new programs, restarts programs whose definitions changed, and removes deleted programs while leaving unrelated programs untouched Does not replace a full daemon restart
restart supervisor or restarting the systemd unit Restarts the entire Supervisor daemon Is not the normal way to apply one application’s configuration edit

For routine edits, use reread then update, not a restart of supervisord. This limits the blast radius: unchanged applications keep running while only the affected definitions are reconciled.

Manage programs with supervisorctl

See every configured program

sudo supervisorctl status

The status command queries the daemon and lists each known program with its current state. Run it after installation, after update, and whenever an application appears unavailable.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Start, stop, and restart one program

sudo supervisorctl start myapp
sudo supervisorctl stop myapp
sudo supervisorctl restart myapp

Replace myapp with the name in your [program:myapp] section. These commands control the child process; they do not alter the configuration file. If you edit the file, return to the reread and update sequence.

Use the interactive shell when several actions are needed

sudo supervisorctl

The client opens a shell-like interface to the daemon. This is convenient for checking status and issuing several start or stop operations without repeatedly invoking the executable. Exit the shell with its standard quit command.

Manage a group of programs

If you define several programs, call the individual names explicitly when you need a predictable change. A broad command can affect more processes than intended, so verify the names shown by supervisorctl status before acting on a production server.

Make a program survive crashes and reboots

Crash recovery

Set autorestart=unexpected when a clean exit means the job completed but an abnormal exit should be retried. This setting is a policy choice: a process that exits immediately because of a bad command or missing file can be restarted repeatedly, so investigate the first failure instead of assuming that automatic restarts solve it.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #4
Ledagic IC+RGBW USB Powered Led Light Bar with App & Remote Control, 2 Pack
  • Easy Installation: Our gaming lights have been designed to enhance your entertainment experience. Simply position the led light bar next to your TV or game console to create a game room environment with ease. They come with USB power and a 60 inch cord for direct mounting and mobility
  • Audio Syncing & Extensive Mode: The built-in high-sensitivity music sensor allows you to sync the TV led lights to your favorite music. Lights react and move to the beat of music, film and game audio, creating an incredible immersive sound and light experience – and all without the need for an additional hub. You can choose from 64+ patterns, including strobe, illusion, jump, energy, gradient, running, chasing, fluttering mode etc. Each mode can be applied to different scenes
  • 64+ Chasing IC+RGB & W Effect: The independent control design of IC+RGB and white all-in-one multifunctional rgbw led bar lights monitor backlight allows you to easily switch the led lights for desk between IC+RGB and white to enjoy a variety of lighting effects, you can choose white lighting mode with high brightness for better illumination when working, etc. Choose IC+RGB lighting mode when you need to create an entertaining atmosphere for the light show, 16 million colours of Color changing rgb light bar let you dance to the beat and create a dynamic party atmosphere
  • Dynamic and Dimmable Lights: 1%-full brightness free brightness adjustment gives you the flexibility to adjust dimmable led light bar for room decorations or a variety of occasions
  • USB Powered: USB light bars for room can be powered by powernank, usb charger, TV, Monitor, laptop PC mainframe, making behind TV led lighting bar easy to install in any location.TV led lights are powered by the TV usb interface / PC mainframe, can be turned on/off synchronously with TV / PC

Boot recovery

Systemd starts supervisor.service when the unit is enabled. Once supervisord is running, it reads the main configuration and its included conf.d files. Keep the application definitions in that included directory, confirm the unit is enabled, and verify the resulting program state with sudo supervisorctl status after a reboot or service start.

Do not confuse a machine reboot with a configuration deployment. A file copied into conf.d still needs reread and update if Supervisor is already running.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Troubleshoot a program that will not start

1. Confirm that the daemon itself is healthy

sudo systemctl status supervisor
sudo supervisorctl status

If systemd reports a failed unit, read /var/log/supervisor/supervisord.log before changing the child configuration. A client connection error often means the daemon is stopped or did not successfully load its main configuration.

2. Check that Supervisor noticed the file

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl status

If reread reports no change when you expected one, verify the file is under /etc/supervisor/conf.d/, ends in .conf, and contains a correctly spelled [program:name] section. A file outside the included directory will not be loaded by the conventional layout.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

3. Run the exact command and paths as the configured user

Check the executable in command, the script path, and directory. An interactive shell may find a command through PATH that systemd or Supervisor cannot. Use the absolute interpreter or executable path shown in the configuration. Then test whether the account named by user can read the application, enter the working directory, and access required files.

4. Inspect child output and the daemon log

Read the files configured by stdout_logfile and stderr_logfile, along with /var/log/supervisor/supervisord.log. Together they distinguish an application error from a Supervisor or configuration error. If a log cannot be opened, create its parent directory and correct ownership and permissions for the process that must write it.

Best Value
Sale
HUANUO FlowLift™ Dual Monitor Stand, Fully Adjustable Gaming Monitor Desk Mount for 13–32″ Computer Screens, Full Motion VESA 75x75/100x100 with C-Clamp & Grommet Base, Each Arm Holds 4.4 to 19.8 lbs
  • Compatible with Wide Screens - To ensure compatibility with the dual monitor mount, your each monitor must meet three conditions at the same time: First, computer screens size range: 13 to 32 inches. Second, screen weight range: 4.4 to 19.8 lbs. Third, the back of the monitor screen must have VESA mounting holes with a pitch of 75x75mm or 100x100mm.
  • Regarding the compatibility with desks - Your desk must meet three conditions at the same time: First, desk material: Only wooden desks are recommended, plastic or glass desks cannot be used. Second, desk thickness range: 0.59" - 3.54". Third, the bottom of the desk should not have any cross beams or panels, as this will interfere with installation. We recommend carefully checking that your desk and monitors meets all above conditions before purchasing.
  • Dual C-Clamp Hold - Worried your dual monitors might wobble or slip? Our upgraded base uses a larger platform plus a dual C-clamp structure to lock the dual monitor arm firmly to your desk. Each arm safely keeps your screens steady while you type, click and game—no shaking, no sliding, just a clean and secure setup you can trust every day. It also provides Grommet Mounting installation choice, both options ensure stable and secure fixation for your 0.59" - 3.54" desk.
  • Full-Motion Adjustment For Comfortable View - Pull the screen closer when you’re deep in a spreadsheet, push it back to watch videos, or rotate to portrait for coding — moving everything smoothly with just one hand. The monitor stand offers +85°/-50° tilt, ±90° swivel and 360° rotation. Raise your monitor up to 15.75″ to support a healthy sitting posture. Whether you’re working from home, gaming through the night, or switching between video calls and documents, getting the screens to your natural line of sight helps relieve neck, shoulder and back strain so you can stay focused longer with less fatigue.
  • Keep Your Desk Organized: By lifting both screens off the desktop, this dual monitor stand opens up valuable space for your keyboard, notebook, docking station or a simple, clutter-free work area. Built-in cable management guides wires along the arms, keeping cords out of sight and out of the way. Enjoy a tidy, modern workstation that looks as good as it feels to use.

5. Look for an intentional clean exit

With autorestart=unexpected, a program that exits cleanly is not treated as a crash. If the command is a one-shot task rather than a long-running service, a stopped state may be the expected result. For a worker that should remain alive, inspect its own output for a missing environment variable, unavailable dependency, invalid working directory, or another startup condition.

Optional HTTP control interface

Supervisor can expose an HTTP control endpoint through an [inet_http_server] block. Treat it as an administrative console, not as a public status page.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
[inet_http_server]
port=127.0.0.1:9001
username=admin
password=change-this

Bind it to localhost unless you have a specific, secured reason to expose it elsewhere. The interface can control processes, so a network-reachable listener is a direct management surface. Configuration files can contain credentials in plaintext; restrict their permissions so unprivileged users cannot read them. If remote administration is required, prefer a protected tunnel or other access control rather than exposing the listener broadly.

Upgrade and version considerations

The upstream documentation set describes Supervisor 4.3.0, while Ubuntu and Debian package versions are controlled by each distribution release and repository. Before relying on a feature or diagnosing a version-specific difference, record the local result of:

supervisord -v
apt-cache policy supervisor

Use apt’s normal upgrade process for an apt installation and review the package’s service status afterward. Preserve your files under /etc/supervisor/, then run sudo supervisorctl reread, sudo supervisorctl update, and sudo supervisorctl status to confirm that the applications are still recognized and running as intended.

Operational checklist

  • Install with sudo apt-get update and sudo apt-get install supervisor.
  • Confirm supervisor.service is active and enabled for boot.
  • Check the installed release with supervisord -v; repository packages may lag upstream 4.3.0 documentation.
  • Keep the main configuration at /etc/supervisor/supervisord.conf and one application file per service in /etc/supervisor/conf.d/.
  • Use absolute command paths, an intentional working directory, and a least-privilege user.
  • Apply edits with sudo supervisorctl reread followed by sudo supervisorctl update.
  • Use sudo supervisorctl status before and after manual start, stop, or restart operations.
  • Read child logs and /var/log/supervisor/supervisord.log when a process fails.
  • Keep any [inet_http_server] listener on localhost, protect it with credentials, and lock down the configuration file.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More quests from Patch Notes

  1. How to Set Up a RedM (RDR2) Server in 2026: License Key, txAdmin and server.cfg, Step by StepBlog11min
  2. Best RedM (RDR2) Server Hosting in 2026: Comparing Four Hosts on Slots, Memory and PriceBlog10min
  3. How to Host a Mindustry Server in 2026: server-release.jar, Port 6567 and the Commands That MatterBlog7min
Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.