Поиск
Справочник

Как установить Supervisor на Ubuntu

Supervisor следит за программами на сервере: запускает их вместе с сервером, поднимает после падения и пишет их вывод в лог. Подходит для бота, обработчика очереди или приложения на Python, которое должно работать без открытого окна SSH.

≈ 9 мин чтения
Содержание 9

Что сделать прямо сейчас

Команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.

  1. Обновите список пакетов: sudo apt update. Если система спросит пароль, введите пароль своего пользователя на сервере. Символы при вводе не видны — так и должно быть: наберите пароль и нажмите Enter. На вопрос Do you want to continue? [Y/n] нажмите Y и Enter.
  2. Поставьте Supervisor: sudo apt install supervisor. Служба запустится сама, проверка — sudo systemctl status supervisor, в ответе должно быть active (running).
  3. Создайте файл настроек для своей программы: sudo nano /etc/supervisor/conf.d/myapp.conf. Что в него вписать — в разделе Файл настроек программы.
  4. Сохраните файл: Ctrl+O, Enter, затем Ctrl+X. Попросите Supervisor прочитать новый файл и запустить программу: sudo supervisorctl reread, затем sudo supervisorctl update.
  5. Проверьте: sudo supervisorctl status. В строке программы должно быть RUNNING и время работы, например pid 2345, uptime 0:00:07.

Файл настроек должен лежать в папке /etc/supervisor/conf.d, а его имя — заканчиваться на .conf: другие файлы Supervisor не читает.

Какая версия поставится

UbuntuВерсия SupervisorРаздел
24.044.2.5universe
26.044.3.0universe

Если apt отвечает, что пакет не найден, — разбор этой ошибки.

Главный файл настроек — /etc/supervisor/supervisord.conf. Править его не нужно: в конце файла стоит строка, которая подключает все файлы из папки /etc/supervisor/conf.d. Общий лог самого Supervisor — /var/log/supervisor/supervisord.log.

Файл настроек программы

Пример для программы на Python, которая лежит в папке /home/ivan/app и запускается из виртуального окружения venv:

[program:myapp]
command=/home/ivan/app/venv/bin/python -u /home/ivan/app/bot.py
directory=/home/ivan/app
user=ivan
environment=HOME="/home/ivan",USER="ivan"
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/var/log/supervisor/myapp.log

Вместо ivan — ваш пользователь на сервере, вместо bot.py — файл программы, вместо myapp — любое короткое имя латиницей.

СтрокаЧто значит
[program:myapp]имя программы в Supervisor — по нему её запускают и останавливают
commandкоманда запуска. Путь к программе пишите полностью, от корня /
directoryпапка, из которой запускается программа
userот какого пользователя работает программа. Без этой строки — от root
environmentпеременные окружения. Строка user не меняет HOME и USER, поэтому их задают здесь
autostart=trueзапускать программу вместе с Supervisor, в том числе после перезагрузки сервера
autorestart=trueподнимать программу после любой остановки. Без этой строки действует значение unexpected: программу, которая завершилась с кодом 0, Supervisor не поднимет
redirect_stderr=trueошибки программы пишутся в тот же лог, что и остальной вывод
stdout_logfileфайл лога. Без этой строки Supervisor выберет имя сам и удалит такой лог при своём перезапуске

Ключ -u у python нужен, чтобы вывод программы сразу попадал в лог. Без него Python копит вывод в памяти, и лог пополняется с задержкой.

Программа не должна сама уходить в фон: держать её запущенной — работа Supervisor. Если у программы есть настройка «работать в фоне» (daemon), выключите её.

Для приложения на Node.js в строке command пишут путь к node и к файлу, например /usr/bin/node /home/ivan/app/server.js. Для Node.js есть и свой менеджер процессов — Как установить PM2 на Ubuntu.

Как Supervisor решает, что запуск удался: программа должна проработать 1 секунду (строка startsecs). Если она падает раньше, Supervisor повторяет запуск до 3 раз (строка startretries) и после этого ставит состояние FATAL.

Если нужно несколько копий программы

Чтобы Supervisor держал несколько одинаковых процессов, например три обработчика очереди, добавьте в блок программы две строки и поменяйте строку лога:

numprocs=3
process_name=%(program_name)s_%(process_num)02d
stdout_logfile=/var/log/supervisor/myapp_%(process_num)02d.log

Процессы получат имена myapp_00, myapp_01 и myapp_02. Без строки process_name Supervisor не примет настройку с numprocs больше единицы. У каждой копии должен быть свой файл лога: в один общий файл с ротацией записи двух процессов перемешаются и испортят его.

В ответе sudo supervisorctl status копии видны как myapp:myapp_00 и так далее. Перезапустить все сразу — sudo supervisorctl restart myapp:*.

Команды supervisorctl

КомандаЧто делает
sudo supervisorctl statusсписок программ и их состояние
sudo supervisorctl restart myappперезапустить программу, например после обновления её файлов
sudo supervisorctl stop myappостановить программу
sudo supervisorctl start myappзапустить программу
sudo supervisorctl tail -f myappпоказывать лог программы по мере записи, выход — Ctrl+C
sudo supervisorctl rereadпрочитать файлы настроек и показать, что изменилось
sudo supervisorctl updateприменить изменения: запустить новые программы, перезапустить изменённые, остановить удалённые

Команда restart не перечитывает файлы настроек. Поменяли файл в /etc/supervisor/conf.d — выполните reread, затем update.

Все команды запускайте с sudo: supervisorctl передаёт их через файл /var/run/supervisor.sock, а доступ к нему есть только у root.

Состояние в statusЧто значит
RUNNINGпрограмма работает
STARTINGпрограмма запускается
BACKOFFпрограмма упала при запуске, Supervisor пробует снова
FATALзапустить не вышло, Supervisor больше не пробует
STOPPEDпрограмма остановлена командой stop или ещё не запускалась
EXITEDпрограмма завершилась сама

Supervisor или systemd

Держать программу запущенной умеет и systemd — он уже есть в Ubuntu, ставить ничего не нужно. Как сделать программу службой systemd, показано в разделе Как запустить программу службой, команды для служб — на странице Команда systemctl.

Supervisor удобен, когда программ несколько или нужно несколько копий одной программы: настройки короче, а состояние всех программ видно одной командой. Выберите что-то одно: если программа уже работает службой systemd, не добавляйте её в Supervisor — запустятся две копии.

Ошибки и как их исправить

Что видитеЧто делать
unix:///var/run/supervisor.sock no such fileSupervisor не запущен. Запустите: sudo systemctl enable --now supervisor. Если служба не стартует, причину покажет sudo journalctl -u supervisor — так бывает при ошибке в файле из /etc/supervisor/conf.d
error: <class 'PermissionError'>, [Errno 13] Permission deniedкоманда supervisorctl запущена без sudo — повторите её с sudo
No config updates to processes после rereadSupervisor не нашёл новых настроек: файл лежит не в /etc/supervisor/conf.d или его имя не заканчивается на .conf
myapp: ERROR (no such process)Supervisor не знает программу с таким именем. Проверьте имя в строке [program:myapp] и выполните sudo supervisorctl reread, затем sudo supervisorctl update
myapp: ERROR (spawn error)программа не запустилась. Причину покажут sudo supervisorctl status и лог: sudo tail -n 50 /var/log/supervisor/myapp.log
в status FATAL и Exited too quickly (process log may have details)программа падает сразу после запуска, причина — в её логе. Попробуйте запустить её вручную: перейдите в папку из строки directory и выполните команду из строки command
в status FATAL и can't find command '…'в строке command неверный путь к программе. Напишите полный путь и проверьте его командой ls -l с этим путём
программа завершилась и не поднимается, в status EXITEDпрограмма вышла с кодом 0, а строки autorestart=true нет. Добавьте её, затем reread и update
лог программы пустой или пополняется с задержкойдля Python добавьте ключ -u в строку command и проверьте, что задана строка stdout_logfile
после правки файла ничего не поменялосьrestart не перечитывает настройки — выполните sudo supervisorctl reread и sudo supervisorctl update
программа не находит файлы в домашней папкедобавьте строку environment=HOME="/home/ivan",USER="ivan" — строка user их не меняет

Источники

Сверено 22 октября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше