PM2 — Comandos Importantes

🚀 Iniciar procesos

1. Iniciar una app suelta

pm2 start app.js --name "mi-app"

2. Iniciar desde un archivo de configuración (ecosystem)

pm2 start ecosystem.config.js

3. Iniciar en modo cluster (aprovecha todos los núcleos)

pm2 start app.js -i max --name "mi-app"

📋 Listar / Estado

pm2 list

pm2 status

Ver detalle de un proceso puntual

pm2 show mi-app

🔄 Reiniciar / Recargar

Reinicio normal (corta el proceso y lo vuelve a levantar)

pm2 restart mi-app

Reload sin downtime (solo aplica en modo cluster)

pm2 reload mi-app

all en vez del nombre aplica la acción a todos los procesos: pm2 restart all

Tanto restart, reload, stop y delete aceptan el ID interno de pm2 en vez del nombre (el que aparece en pm2 list): pm2 restart 2

⏹️ Detener / Eliminar

pm2 stop mi-app

pm2 delete mi-app

📜 Logs

Ver logs en vivo (todos los procesos)

pm2 logs

Ver logs de un proceso puntual

pm2 logs mi-app

Vaciar los logs acumulados

pm2 flush

📊 Monitoreo

Dashboard en terminal (CPU / memoria en vivo)

pm2 monit

💾 Persistencia y arranque automático

1. Guardar la lista actual de procesos

pm2 save

2. Generar el servicio de arranque (systemd) — imprime un comando para copiar y correr con sudo

pm2 startup

3. Quitar el arranque automático

pm2 unstartup

Después de pm2 startup, cualquier cambio en los procesos requiere pm2 save de nuevo para que persista tras un reinicio del servidor.

🔁 Actualizar pm2

npm install pm2@latest -g

pm2 update