How to Set Up Supervisor on Ubuntu

How to Set Up Supervisor on Ubuntu

Managing processes in a server environment can be a daunting task, but tools like Supervisor make it easier. Supervisor is a well-known system that allows for easy monitoring and control of individual processes on UNIX-like operating systems. This guide aims to simplify the setup process of Supervisor, making server management more efficient. We’ll take you through the steps to get your Supervisor running on your system, ensuring that your applications run smoothly even when unexpected interruptions occur.

What is Supervisor?

Supervisor is a process control system that enables users to monitor and control UNIX-like operating system processes. It assists in managing processes that should be kept running continuously in a system by providing mechanisms to start, stop, and restart processes based on configurations or events. Supervisor is particularly useful for developers and system administrators who need to control and monitor the status of multiple processes on Linux or other UNIX-like operating systems. Here are some key points about Supervisor:

  1. Configuration. Supervisor uses a simple configuration file to manage processes and can start processes in the correct order, handle process dependencies, and manage process states.
  2. Monitoring. It continuously monitors the running processes to ensure they are functioning as expected. If a process controlled by Supervisor crashes or stops for some reason, Supervisor can be configured to restart it automatically.
  3. Log Management. Supervisor can also handle logging for managed processes, ensuring that log files are rotated and maintained appropriately.
  4. Web Interface and Command Line. Supervisor provides a web-based user interface and a command-line interface for managing and monitoring processes.
  5. Grouping. It allows grouping of processes that can be controlled together, which is useful when managing microservices or applications with multiple parts.
  6. Event Notifications. Supervisor can emit events when the state of a managed process changes, which can be used to integrate with other monitoring or alerting systems.

Utilizing Supervisor can significantly simplify the task of process management on UNIX-like operating systems, making it easier to ensure that critical applications and services remain up and running.

How to Install Supervisor on Ubuntu

It is easy to set up Supervisor on Ubuntu 20.04. Follow these step-by-step instructions:

1.  Update Your System. Firstly, it’s good practice to update the package database and upgrade the system to the latest available versions. 

sudo apt update && sudo apt upgrade -y

2. Install Supervisor. Install Supervisor from the Ubuntu package manager.

sudo apt install supervisor -y

Sample output:

 A screenshot of a terminal window displaying the command 'sudo apt install supervisor -y' being executed to install Supervisor on an Ubuntu system.

3. Check Supervisor Status. After installation, Supervisor should start automatically. You can check its status with this command.

sudo systemctl status supervisor

Sample output:

A screenshot of a terminal window displaying the command 'sudo systemctl status supervisor' being executed to check the status of Supervisor on an Ubuntu system.

4. Configure Supervisor. Create a new Supervisor configuration file for your process. For example, to manage a simple script, create a file at /etc/supervisor/conf.d/myscript.conf with the following content:


Replace /path/to/your/ with the actual path to your script.

5. Update Supervisor Configuration. Inform Supervisor about the new configuration and update it.

sudo supervisorctl reread
sudo supervisorctl update

6. Start Your Process. Start your process with Supervisor by running this command:

sudo supervisorctl start myscript

7. Monitor Your Process. You can now monitor the status of your process using Supervisor.

sudo supervisorctl status myscript

8. Supervisor Web Interface (Optional).  If you want to enable the web interface for Supervisor, you’ll need to edit the main Supervisor configuration file.

sudo nano /etc/supervisor/supervisord.conf

Add or update the following lines in the [inet_http_server] section:


Replace user and pass with your desired username and password, save the file, and then restart Supervisor.

sudo systemctl restart supervisor

Now you can access the Supervisor web interface at http://your-server-ip:9001.

Congratulations on installing Supervisor on your Ubuntu system! This tool simplifies process management and monitoring, aiding in continuous operation of essential processes. By following this guide, you’ve added a robust tool to your setup, crucial for uninterrupted application functioning in a production environment. Explore Supervisor’s features and configurations further to customize its operations to your needs, fostering a more efficient server ecosystem.


Want to run Ubuntu in a virtual environment? With Gcore Cloud, you can choose from Basic VM, Virtual Instances, or VPS/VDS suitable for Ubuntu:

Choose an instance

Subscribe to our newsletter

Stay informed about the latest updates, news, and insights.