Как установить Supervisor на Ubuntu
Supervisor следит за программами на сервере: запускает их вместе с сервером, поднимает после падения и пишет их вывод в лог. Подходит для бота, обработчика очереди или приложения на Python, которое должно работать без открытого окна SSH.
Содержание 9
Что сделать прямо сейчас
Команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
- Обновите список пакетов:
sudo apt update. Если система спросит пароль, введите пароль своего пользователя на сервере. Символы при вводе не видны — так и должно быть: наберите пароль и нажмите Enter. На вопросDo you want to continue? [Y/n]нажмите Y и Enter. - Поставьте Supervisor:
sudo apt install supervisor. Служба запустится сама, проверка —sudo systemctl status supervisor, в ответе должно бытьactive (running). - Создайте файл настроек для своей программы:
sudo nano /etc/supervisor/conf.d/myapp.conf. Что в него вписать — в разделе Файл настроек программы. - Сохраните файл: Ctrl+O, Enter, затем Ctrl+X. Попросите Supervisor прочитать новый файл и запустить программу:
sudo supervisorctl reread, затемsudo supervisorctl update. - Проверьте:
sudo supervisorctl status. В строке программы должно бытьRUNNINGи время работы, напримерpid 2345, uptime 0:00:07.
Файл настроек должен лежать в папке /etc/supervisor/conf.d, а его имя — заканчиваться на .conf: другие файлы Supervisor не читает.
Какая версия поставится
| Ubuntu | Версия Supervisor | Раздел |
|---|---|---|
| 24.04 | 4.2.5 | universe |
| 26.04 | 4.3.0 | universe |
Если 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 file | Supervisor не запущен. Запустите: 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 после reread | Supervisor не нашёл новых настроек: файл лежит не в /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 их не меняет |
Источники
- Пакет supervisor в Ubuntu 24.04 — версия 4.2.5, раздел universe.
- Пакет supervisor в Ubuntu 26.04 — версия 4.3.0, раздел universe.
- Файл настроек Supervisor в Ubuntu — файл сокета и права на него, папка логов, подключение conf.d.
- Служба supervisor — как systemd запускает Supervisor.
- Документация: настройки программы — command, directory, user, environment, autorestart, startsecs, startretries, stdout_logfile, numprocs.
- Документация: команды supervisorctl — reread, update, restart, tail.
- supervisorctl.py, process.py, options.py и rpcinterface.py — тексты ошибок и строка status.
- Ключ -u в документации Python — вывод без буфера.
Сверено 22 октября 2026 года.
Что почитать дальше
- Команда systemctlкак запускать и останавливать службы.
- Как установить Node.js на Ubuntuесли программа написана на Node.js.
- Как установить PM2 на Ubuntuменеджер процессов для Node.js.
- Установка программ на Ubuntuчто ещё поставить на сервер.
- Все ошибки Python и pipесли программа на Python, запущенная через supervisor, останавливается с ошибкой.
- Очереди Laravel и Supervisorготовый файл Supervisor для воркеров Laravel.