Download Code

Obtain the code from the official GitHub repository:

# Download the latest version of the code
curl -LO https://github.com/perfect-panel/ppanel-web/releases/download/v1.0.0/ppanel-admin-web.tar.gz
 
# Extract the files
tar -xzvf ppanel-admin-web.tar.gz
 
# Navigate to the code directory
cd ppanel-admin-web

Configure Environment Variables

Create the apps/admin/.env file and add the necessary environment variables (refer to the environment variable configuration mentioned above).

Configure PM2

Create the ecosystem.config.js file with the following content:

module.exports = {
  apps: [
    {
      name: 'ppanel-admin-web',
      script: 'apps/admin/server.js',
      interpreter: 'bun', // can be changed to node
      watch: true,
      instances: 'max',
      exec_mode: 'cluster',
      env: {
        PORT: 3000,
      },
    },
  ],
};

Start the Service Using PM2

pm2 start ecosystem.config.js
pm2 save
pm2 startup

Start the Service Using Node.js or Bun

• Starting with Node.js:

  node apps/admin/server.js

• Starting with Bun:

  bun apps/admin/server.js

4. Verify Deployment

4.1 PM2 Service Status

Run the following command to check:

pm2 list

4.2 Browser Access

Visit http://<Your Server IP>:3000 to verify the service is running.

5. Service Management

PM2 Commands

• Stop the service:

  pm2 stop ppanel-admin-web

• Restart the service:

  pm2 restart ppanel-admin-web

• Delete the service:

  pm2 delete ppanel-admin-web