Как установить PM2 на Ubuntu
PM2 держит приложение на Node.js запущенным: поднимает его после падения, запускает вместе с сервером и собирает его вывод в логи. Приложение работает и после того, как вы закрыли окно SSH.
Содержание 12
- Что сделать прямо сейчас
- Какая версия поставится
- Запуск после перезагрузки сервера
- Почему PM2 запускают без sudo
- Команды PM2
- Файл настроек ecosystem.config.js
- Если нужно несколько копий приложения
- Программы на Python и других языках
- PM2, Supervisor или systemd
- Ошибки и как их исправить
- Источники
- Что почитать дальше
Что сделать прямо сейчас
Команды на этой странице вводятся на сервере: подключитесь к нему по 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.
- Поставьте PM2:
sudo npm install -g pm2. Ключ-gставит программу для всей системы, sudo нужен для записи в папку /usr/local. - Проверьте:
pm2 --version— в ответе номер версии, например7.1.0. - Перейдите в папку приложения:
cd /home/ivan/myapp. Вместо ivan — ваш пользователь на сервере, вместо myapp — папка приложения. - Запустите приложение:
pm2 start app.js --name myapp. Вместо app.js — главный файл приложения, myapp — имя, по которому вы будете им управлять. Пишите без sudo. - Проверьте:
pm2 list. В строке myapp в столбце status должно бытьonline. - Включите автозапуск:
pm2 startup. PM2 напечатает строку, которая начинается сsudo env PATH=— скопируйте её целиком, вставьте и нажмите Enter. Подробнее — в разделе Запуск после перезагрузки сервера. - Запомните список приложений:
pm2 save. После перезагрузки PM2 запустит именно его.
Приложение на Node.js слушает свой порт, например 3000, а чтобы сайт открывался по адресу без номера порта, перед приложением ставят nginx — как это сделать.
Какая версия поставится
PM2 нет среди пакетов Ubuntu: npm скачивает последнюю версию с сайта npm. На 22 октября 2026 года это 7.1.0. Ей нужен Node.js версии 18 или новее — подходят обе Ubuntu:
| Ubuntu | Node.js из apt | npm из apt | PM2 7.1.0 |
|---|---|---|---|
| 24.04 | 18.19.1 | 9.2.0 | подходит |
| 26.04 | 22.22.1 | 9.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 сейчас его перезапустит |
errored | PM2 перестал перезапускать приложение — смотрите ошибки |
Логи лежат в папке ~/.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 — запустятся две копии и вторая не сможет занять порт.
Ошибки и как их исправить
| Что видите | Что делать |
|---|---|
| система не находит команду pm2 | PM2 не установлен или поставлен без ключа -g. Выполните sudo npm install -g pm2 и проверьте ls -l /usr/local/bin/pm2 |
| система не находит команду npm | npm ставится отдельным пакетом: 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 PATH | Python не установлен: sudo apt install python3 — или укажите путь ключом --interpreter |
| 502 Bad Gateway в браузере | приложение не запущено или слушает другой порт: pm2 list, pm2 logs myapp, разбор ошибки |
| после обновления Node.js приложения не стартуют вместе с сервером | пересоздайте службу: pm2 unstartup, затем pm2 startup — и выполните строки, которые они напечатают |
Источники
- PM2 в реестре npm — версия 7.1.0 от 21 октября 2026 года, требование Node.js 18 или новее, лицензия AGPL-3.0.
- Документация PM2: быстрый старт — установка, команды start, list, logs, restart, reload, stop, delete, monit, ключи --name, --time, --watch, --max-memory-restart, -i.
- Документация PM2: автозапуск — startup, save, unstartup, обновление после смены версии Node.js.
- Startup.js и шаблон службы systemd — какую строку печатает pm2 startup и что делает служба pm2-пользователь.
- God.js и API.js — перезапуск после падения, статус errored, тексты ошибок.
- Common.js, interpreter.json и paths.js — выбор интерпретатора по расширению файла, папка ~/.pm2, имена логов.
- Настройки npm в Ubuntu — папка /usr/local для программ, поставленных с ключом -g.
- Пакет nodejs в Ubuntu 24.04 — Node.js 18.19.1.
- Пакет nodejs в Ubuntu 26.04 — Node.js 22.22.1.
- Пакет npm в Ubuntu 24.04 — npm 9.2.0.
Сверено 22 октября 2026 года.
Что почитать дальше
- Как установить Node.js на Ubuntuесли Node.js ещё не стоит.
- Как установить Supervisor на Ubuntuменеджер процессов для программ на Python.
- Команда systemctlкак управлять службами, в том числе pm2-ivan.
- Установка программ на Ubuntuчто ещё поставить на сервер.
- Все ошибки Node.js и npmразборы по тексту сообщения.