Deploy with Ubuntu Server with PM2

This guide will walk you through the steps to deploy Sales Agent frontend web application to an Ubuntu server using PM2, a process manager for Node.js applications. PM2 will help you keep your app running in the background, restart it automatically when it crashes, and manage logs for easier troubleshooting.

Prerequisites

• Ubuntu Server: This guide assumes you have an Ubuntu server running, and you can access it via SSH.
• Node.js & npm: Make sure Node.js and npm (Node package manager) are installed on your server.
• PM2: PM2 should be installed globally.

npm install -g pm2

• pnpm

npm install -g pnpm

• Frontend Application: Clone the frontend source code and push to your GitHub repository.

Build code

• Please follow instructions here to set up all necessary things and build the code

Start the Application with PM2

Now that your app is built, create a file named ecosystem.config.cjs in the root of your project with the following content. Ensure that the script path points to your app's build output directory (e.g., .output/server/index.mjs for Nuxt 3)

module.exports = {
  apps: [
    {
      name: "SalesAgentApp",
      port: "3000",
      exec_mode: "cluster",
      instances: "max",
      script: "./.output/server/index.mjs",
    },
  ],
};

Once saved, you can start the app with:

pm2 start ecosystem.config.cjs