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

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

PM2 держит приложение на Node.js запущенным: поднимает его после падения, запускает вместе с сервером и собирает его вывод в логи. Приложение работает и после того, как вы закрыли окно SSH.

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

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

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

PM2 ставится через npm, поэтому сначала нужны Node.js и npm — Как установить Node.js на Ubuntu. Коротко: sudo apt update, затем sudo apt install nodejs npm. Если система спросит пароль, введите пароль своего пользователя на сервере. Символы при вводе не видны — так и должно быть: наберите пароль и нажмите Enter. На вопрос Do you want to continue? [Y/n] нажмите Y и Enter.

  1. Поставьте PM2: sudo npm install -g pm2. Ключ -g ставит программу для всей системы, sudo нужен для записи в папку /usr/local.
  2. Проверьте: pm2 --version — в ответе номер версии, например 7.1.0.
  3. Перейдите в папку приложения: cd /home/ivan/myapp. Вместо ivan — ваш пользователь на сервере, вместо myapp — папка приложения.
  4. Запустите приложение: pm2 start app.js --name myapp. Вместо app.js — главный файл приложения, myapp — имя, по которому вы будете им управлять. Пишите без sudo.
  5. Проверьте: pm2 list. В строке myapp в столбце status должно быть online.
  6. Включите автозапуск: pm2 startup. PM2 напечатает строку, которая начинается с sudo env PATH= — скопируйте её целиком, вставьте и нажмите Enter. Подробнее — в разделе Запуск после перезагрузки сервера.
  7. Запомните список приложений: pm2 save. После перезагрузки PM2 запустит именно его.

Приложение на Node.js слушает свой порт, например 3000, а чтобы сайт открывался по адресу без номера порта, перед приложением ставят nginx — как это сделать.

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

PM2 нет среди пакетов Ubuntu: npm скачивает последнюю версию с сайта npm. На 22 октября 2026 года это 7.1.0. Ей нужен Node.js версии 18 или новее — подходят обе Ubuntu:

UbuntuNode.js из aptnpm из aptPM2 7.1.0
24.0418.19.19.2.0подходит
26.0422.22.19.2.0подходит

Если приложению нужен Node.js новее, чем в Ubuntu, — как поставить другую версию. PM2 после этого поставьте заново той же командой sudo npm install -g pm2.

PM2 окажется в /usr/local/bin/pm2, его файлы — в /usr/local/lib/node_modules/pm2. Обновить PM2: sudo npm install -g pm2@latest, затем pm2 update — эта команда перезапустит PM2 с сохранённым списком приложений.

Запуск после перезагрузки сервера

Команда pm2 startup, запущенная без sudo, ничего не меняет в системе — она печатает строку, которую нужно выполнить. Для пользователя ivan и Node.js из Ubuntu строка такая:

sudo env PATH=$PATH:/usr/bin /usr/local/lib/node_modules/pm2/bin/pm2 startup systemd -u ivan --hp /home/ivan

Копируйте ту строку, которую напечатал ваш сервер: в ней ваш пользователь и путь к вашему Node.js. Строка создаёт службу systemd с именем pm2-ivan и включает её. Проверка — sudo systemctl status pm2-ivan: служба должна быть enabled.

При загрузке сервера служба запускает PM2, а он поднимает приложения из списка, сохранённого командой pm2 save. Список хранится в файле ~/.pm2/dump.pm2. Добавили или удалили приложение — снова выполните pm2 save.

После обновления Node.js пересоздайте службу: pm2 unstartup и выполните строку, которую он напечатает, затем pm2 startup и тоже выполните его строку.

Почему PM2 запускают без sudo

У каждого пользователя свой PM2 и свой список приложений — в папке ~/.pm2 его домашней папки. Если запустить sudo pm2 start app.js, приложение попадёт в список пользователя root и будет работать от root: pm2 list без sudo его не покажет, а служба pm2-ivan не запустит его после перезагрузки.

Запускайте приложения, сохраняйте список и включайте автозапуск под одним и тем же пользователем — тем, от которого приложение должно работать.

Команды PM2

КомандаЧто делает
pm2 listсписок приложений и их состояние
pm2 logsвывод всех приложений в реальном времени, выход — Ctrl+C
pm2 logs myapp --lines 200последние 200 строк лога одного приложения
pm2 restart myappперезапустить, например после загрузки новой версии кода
pm2 reload myappперезапуск без остановки — работает в режиме нескольких копий, иначе то же, что restart
pm2 stop myappостановить, приложение остаётся в списке
pm2 start myappзапустить остановленное приложение
pm2 delete myappостановить и убрать из списка
pm2 describe myappподробности: папка, пути к логам, число перезапусков
pm2 monitнагрузка на процессор и память по приложениям, выход — Ctrl+C
pm2 flushочистить логи всех приложений
pm2 saveзапомнить список для запуска после перезагрузки

Вместо имени можно писать номер из столбца id в pm2 list или слово all — команда сработает для всех приложений.

СтатусЧто значит
onlineприложение работает
stoppedостановлено командой stop
launchingзапускается
waiting restartупало, PM2 сейчас его перезапустит
erroredPM2 перестал перезапускать приложение — смотрите ошибки

Логи лежат в папке ~/.pm2/logs: вывод приложения — в myapp-out.log, ошибки — в myapp-error.log. Чтобы в логе была дата и время каждой строки, запустите приложение с ключом --time.

Файл настроек ecosystem.config.js

Когда ключей запуска много, их удобнее держать в файле. Создайте его в папке приложения: nano /home/ivan/myapp/ecosystem.config.js и вставьте:

module.exports = {
  apps: [{
    name: 'myapp',
    script: 'app.js',
    cwd: '/home/ivan/myapp',
    max_memory_restart: '300M',
    env: {
      NODE_ENV: 'production',
      PORT: 3000
    }
  }]
}

Запуск — pm2 start ecosystem.config.js, затем pm2 save. Строка cwd — папка приложения, env — переменные окружения, max_memory_restart перезапустит приложение, если оно займёт больше 300 МБ памяти. Пустой файл-шаблон создаёт команда pm2 ecosystem.

После правки файла выполните pm2 delete myapp, затем pm2 start ecosystem.config.js и pm2 save — так PM2 точно возьмёт новые настройки.

Если нужно несколько копий приложения

Команда pm2 start app.js --name myapp -i max запускает по копии приложения на каждое ядро процессора, а запросы делятся между ними. Вместо max можно написать число копий. Так работают только приложения на Node.js и Bun, и само приложение не должно хранить данные в памяти между запросами — например, сессии пользователей.

Программы на Python и других языках

PM2 запускает не только Node.js: для файла .py он берёт python или python3, для .sh — bash. Для программы из виртуального окружения укажите его Python явно:

pm2 start /home/ivan/app/bot.py --name mybot --interpreter /home/ivan/app/venv/bin/python

Вывод Python PM2 пишет в лог сразу, без задержки. Если на сервере нет Node.js и других программ на нём, для Python удобнее Как установить Supervisor на Ubuntu — его ставят из пакетов Ubuntu.

PM2, Supervisor или systemd

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

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

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

Что видитеЧто делать
система не находит команду pm2PM2 не установлен или поставлен без ключа -g. Выполните sudo npm install -g pm2 и проверьте ls -l /usr/local/bin/pm2
система не находит команду npmnpm ставится отдельным пакетом: sudo apt install npm
при установке npm пишет EACCESне хватает прав на папку /usr/local — повторите команду с sudo: sudo npm install -g pm2, разбор ошибки
[PM2][ERROR] Script not found: /home/ivan/myapp/app.jsпо этому пути нет файла. Перейдите в папку приложения командой cd или напишите полный путь к файлу
[PM2][ERROR] Process or Namespace myapp not foundв списке нет приложения с таким именем. Проверьте pm2 list. Если приложение запускали через sudo, оно в списке root: sudo pm2 list
в status erroredприложение падало быстрее чем за секунду после запуска, и так 16 раз подряд — PM2 перестал его поднимать. Причину покажет pm2 logs myapp --lines 50. Исправьте её и выполните pm2 restart myapp
после перезагрузки сервера pm2 list пустойне выполнен pm2 save или строка из pm2 startup. Проверьте sudo systemctl status pm2-ivan и что команды выполнялись под тем же пользователем
[PM2][WARN] PM2 is not managing any process, skipping save...список пуст — сначала запустите приложение, потом pm2 save
[PM2][WARN] python and python3 binaries not available in PATHPython не установлен: sudo apt install python3 — или укажите путь ключом --interpreter
502 Bad Gateway в браузереприложение не запущено или слушает другой порт: pm2 list, pm2 logs myapp, разбор ошибки
после обновления Node.js приложения не стартуют вместе с серверомпересоздайте службу: pm2 unstartup, затем pm2 startup — и выполните строки, которые они напечатают

Источники

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

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

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