@drocketxx/pm2me 1.1.1 → 1.1.4

package/README.md

@@ -10,32 +10,42 @@ PM2Me lets you **deploy apps directly from a GitHub repository**, manage PM2 pro
 
 ---
 
-## 🚀 Quick Start (Global Install)
+## 🚀 Recommended Installation
 
-The easiest way to use PM2Me is to install it globally via npm:
+The standard way to use PM2Me is to install it globally via npm:
 
 ```bash
-# 1. Install globally
+# Install globally
 npm install -g @drocketxx/pm2me
-
-# 2. Run the server
-pm2me
 ```
 
-Open your browser at: **http://localhost:12345**
-
 ---
 
-## 🛠️ Running as a Background Service
+## 📋 Commands
 
-If you want PM2Me to run in the background and start automatically on system boot, use the built-in `service` command:
+### Standard Execution
+```bash
+# Run the server in foreground
+pm2me
+
+# Run on a custom port
+pm2me --port 8080
+```
+
+### Background Service (Recommended)
+Manage PM2Me as a system service using these commands:
 
 ```bash
-# Install as a background service (using PM2)
+# Install & start as a background service (using PM2)
 pm2me service install
 
-# To remove the background service
+# Uninstall/Remove the service
 pm2me service uninstall
+
+# Control the service
+pm2me service start
+pm2me service stop
+pm2me service restart
 ```
 
 > **Note:** The `service install` command will register PM2Me as `pm2me-server` in PM2 and attempt to set up system startup.

package/backend/routes/api.js

@@ -45,7 +45,7 @@ router.get('/pm2/version-check', async (req, res) => {
         // Check globally installed PM2 version via npm (avoids local node_modules/.bin/pm2)
         let installedVersion = null;
         try {
-            const { stdout } = await execAsync('npm list -g pm2 --depth=0 --json');
+            const { stdout } = await execAsync('npm list -g pm2 --depth=0 --json', { windowsHide: true });
             const parsed = JSON.parse(stdout);
             installedVersion = parsed?.dependencies?.pm2?.version || null;
         } catch {
@@ -404,7 +404,7 @@ export const performDeployment = async (appId, io) => {
             await setPipelineState('building');
             logProcess('Executing Build Script', true);
             await new Promise((resolve, reject) => {
-                const child = exec(normalizedScript, { cwd: targetPath, maxBuffer: 10 * 1024 * 1024 });
+                const child = exec(normalizedScript, { cwd: targetPath, maxBuffer: 10 * 1024 * 1024, windowsHide: true });
                 child.stdout.on('data', data => { io.emit(`deploy-log-${appId}`, data.toString()); fs.appendFileSync(logFilePath, data); });
                 child.stderr.on('data', data => { io.emit(`deploy-log-${appId}`, data.toString()); fs.appendFileSync(logFilePath, data); });
                 child.on('close', code => {
@@ -1023,7 +1023,7 @@ router.post('/system/update', async (req, res) => {
             cmd = 'git pull origin main && npm run build';
             cwd = path.resolve(__dirname, '../..');
         }
-        const { stdout, stderr } = await execAsync(cmd, { cwd }).catch(err => ({
+        const { stdout, stderr } = await execAsync(cmd, { cwd, windowsHide: true }).catch(err => ({
             stdout: '', stderr: err.message
         }));
         const output = [stdout, stderr].filter(Boolean).join('\n').trim();

package/backend/services/gitService.js

@@ -28,9 +28,9 @@ export const syncRepo = async (repoUrl, targetPath, branchName, token = null) =>
             fs.rmSync(targetPath, { recursive: true, force: true });
         }
         fs.mkdirSync(targetPath, { recursive: true });
-        const git = simpleGit().env(envOptions);
+        const git = simpleGit({ spawnOptions: { windowsHide: true } }).env(envOptions);
         await git.clone(finalUrl, targetPath, ['--branch', branchName]);
-        const gitLocal = simpleGit(targetPath);
+        const gitLocal = simpleGit(targetPath, { spawnOptions: { windowsHide: true } });
         const log = await gitLocal.log(['-1']);
         const commitHash = log.latest.hash;
         const commitMessage = log.latest.message;
@@ -45,7 +45,7 @@ export const syncRepo = async (repoUrl, targetPath, branchName, token = null) =>
         }
     } else {
         try {
-            const git = simpleGit(targetPath).env(envOptions);
+            const git = simpleGit(targetPath, { spawnOptions: { windowsHide: true } }).env(envOptions);
             await git.remote(['set-url', 'origin', finalUrl]);
             await git.fetch('origin', branchName);
             await git.checkout(branchName);
@@ -68,7 +68,7 @@ export const syncRepo = async (repoUrl, targetPath, branchName, token = null) =>
 
 export const getBranches = async (repoUrl, token = null) => {
     const finalUrl = getFinalUrl(repoUrl, token);
-    const git = simpleGit().env({ ...process.env, GIT_TERMINAL_PROMPT: '0' });
+    const git = simpleGit({ spawnOptions: { windowsHide: true } }).env({ ...process.env, GIT_TERMINAL_PROMPT: '0' });
     const branches = await git.listRemote(['--heads', finalUrl]);
     // Parse branch output, simplistic split
     return branches.split('\n').filter(Boolean).map(line => line.split('refs/heads/')[1]);
@@ -82,7 +82,7 @@ export const getBehindCount = async (repoUrl, targetPath, branchName, token = nu
     if (!isGitRepo) return 0;
 
     const finalUrl = getFinalUrl(repoUrl, token);
-    const git = simpleGit(targetPath).env({ ...process.env, GIT_TERMINAL_PROMPT: '0' });
+    const git = simpleGit(targetPath, { spawnOptions: { windowsHide: true } }).env({ ...process.env, GIT_TERMINAL_PROMPT: '0' });
 
     try {
         await git.remote(['set-url', 'origin', finalUrl]);
@@ -96,7 +96,7 @@ export const getBehindCount = async (repoUrl, targetPath, branchName, token = nu
 };
 
 export const checkout = async (targetPath, ref) => {
-    const git = simpleGit(targetPath).env({ ...process.env, GIT_TERMINAL_PROMPT: '0' });
+    const git = simpleGit(targetPath, { spawnOptions: { windowsHide: true } }).env({ ...process.env, GIT_TERMINAL_PROMPT: '0' });
     try {
         await git.checkout(ref);
         const log = await git.log(['-1']);

package/backend/services/systemService.js

@@ -32,7 +32,7 @@ export const getSystemStats = async () => {
             const promises = [];
 
             // 1. CPU Usage (Every time)
-            const cpuPromise = execPromise('powershell -Command "(Get-Counter \'\\Processor(_Total)\\% Processor Time\' -ErrorAction SilentlyContinue).CounterSamples.CookedValue"')
+            const cpuPromise = execPromise('powershell -Command "(Get-Counter \'\\Processor(_Total)\\% Processor Time\' -ErrorAction SilentlyContinue).CounterSamples.CookedValue"', { windowsHide: true })
                 .then(({ stdout }) => {
                     const realCpu = parseFloat(stdout.trim());
                     if (!isNaN(realCpu)) cpuUsage = realCpu;
@@ -41,7 +41,7 @@ export const getSystemStats = async () => {
             promises.push(cpuPromise);
 
             // 2. Network Stats (Every time)
-            const netPromise = execPromise('powershell -Command "Get-NetAdapterStatistics | Select-Object ReceivedBytes, SentBytes | ConvertTo-Json"')
+            const netPromise = execPromise('powershell -Command "Get-NetAdapterStatistics | Select-Object ReceivedBytes, SentBytes | ConvertTo-Json"', { windowsHide: true })
                 .then(({ stdout }) => {
                     const netData = JSON.parse(stdout);
                     let totalRx = 0;
@@ -67,7 +67,7 @@ export const getSystemStats = async () => {
 
             // 3. Disk Stats (Cached)
             if (now - cachedDiskStats.lastFetch > DISK_CACHE_TTL) {
-                const diskPromise = execPromise('powershell -Command "Get-Volume -DriveLetter C | Select-Object Size, SizeRemaining | ConvertTo-Json"')
+                const diskPromise = execPromise('powershell -Command "Get-Volume -DriveLetter C | Select-Object Size, SizeRemaining | ConvertTo-Json"', { windowsHide: true })
                     .then(({ stdout }) => {
                         const data = JSON.parse(stdout);
                         if (data.Size > 0) {

package/bin/pm2me.js

@@ -5,6 +5,9 @@
  *   pm2me                      (Run in foreground)
  *   pm2me service install      (Run in background via PM2 + set boot startup)
  *   pm2me service uninstall    (Remove from PM2 background)
+ *   pm2me service start        (Start background service)
+ *   pm2me service stop         (Stop background service)
+ *   pm2me service restart      (Restart background service)
  */
 import path from 'path';
 import { fileURLToPath } from 'url';
@@ -22,6 +25,8 @@ const args = process.argv.slice(2);
 // ── Handle Service Commands ───────────────────────────────────────────────────
 if (args[0] === 'service') {
     const action = args[1];
+    const SERVICE_NAME = 'pm2me-server';
+
     if (action === 'install') {
         console.log('[pm2me] Installing background service...');
         try {
@@ -30,21 +35,21 @@ if (args[0] === 'service') {
             const homeDir = path.join(os.homedir(), '.pm2me');
             const dbPath = path.join(homeDir, 'database.json');
 
-            console.log(`[pm2me] Starting via PM2 as 'pm2me-server'...`);
-            execSync(`pm2 start "${appPath}" --name pm2me-server --env PM2ME_DB_PATH="${dbPath}"`, { stdio: 'inherit' });
+            console.log(`[pm2me] Starting via PM2 as '${SERVICE_NAME}'...`);
+            execSync(`pm2 start "${appPath}" --name ${SERVICE_NAME} --env PM2ME_DB_PATH="${dbPath}"`, { stdio: 'inherit', windowsHide: true });
 
             console.log(`[pm2me] Saving PM2 process list...`);
-            execSync(`pm2 save`, { stdio: 'inherit' });
+            execSync(`pm2 save`, { stdio: 'inherit', windowsHide: true });
 
             if (isWindows) {
-                console.log(`\n[pm2me] 💡 Windows Info: 'pm2me-server' is now running in the background.`);
+                console.log(`\n[pm2me] 💡 Windows Info: '${SERVICE_NAME}' is now running in the background.`);
                 console.log(`[pm2me] To make it start automatically on Windows restart, we recommend using 'pm2-windows-startup':`);
                 console.log(`        npm install -g pm2-windows-startup`);
                 console.log(`        pm2-startup install`);
             } else {
                 console.log(`[pm2me] Setting up boot startup...`);
                 try {
-                    execSync(`pm2 startup`, { stdio: 'inherit' });
+                    execSync(`pm2 startup`, { stdio: 'inherit', windowsHide: true });
                     console.log(`[pm2me] Done! If you see a command above, please copy and run it to finalize startup.`);
                 } catch (e) {
                     console.log(`[pm2me] 'pm2 startup' might need manual execution. Check instructions above.`);
@@ -60,16 +65,43 @@ if (args[0] === 'service') {
     } else if (action === 'uninstall') {
         console.log('[pm2me] Uninstalling background service...');
         try {
-            execSync(`pm2 delete pm2me-server`, { stdio: 'inherit' });
-            execSync(`pm2 save`, { stdio: 'inherit' });
+            execSync(`pm2 delete ${SERVICE_NAME}`, { stdio: 'inherit', windowsHide: true });
+            execSync(`pm2 save`, { stdio: 'inherit', windowsHide: true });
             console.log(`[pm2me] Service uninstalled successfully.`);
             process.exit(0);
         } catch (err) {
             console.error(`[pm2me] Failed to uninstall service:`, err.message);
             process.exit(1);
         }
+    } else if (action === 'start') {
+        console.log(`[pm2me] Starting service '${SERVICE_NAME}'...`);
+        try {
+            execSync(`pm2 start ${SERVICE_NAME}`, { stdio: 'inherit', windowsHide: true });
+            process.exit(0);
+        } catch (err) {
+            console.error(`[pm2me] Failed to start service:`, err.message);
+            process.exit(1);
+        }
+    } else if (action === 'stop') {
+        console.log(`[pm2me] Stopping service '${SERVICE_NAME}'...`);
+        try {
+            execSync(`pm2 stop ${SERVICE_NAME}`, { stdio: 'inherit', windowsHide: true });
+            process.exit(0);
+        } catch (err) {
+            console.error(`[pm2me] Failed to stop service:`, err.message);
+            process.exit(1);
+        }
+    } else if (action === 'restart') {
+        console.log(`[pm2me] Restarting service '${SERVICE_NAME}'...`);
+        try {
+            execSync(`pm2 restart ${SERVICE_NAME}`, { stdio: 'inherit', windowsHide: true });
+            process.exit(0);
+        } catch (err) {
+            console.error(`[pm2me] Failed to restart service:`, err.message);
+            process.exit(1);
+        }
     } else {
-        console.log(`Usage: pm2me service [install|uninstall]`);
+        console.log(`Usage: pm2me service [install|uninstall|start|stop|restart]`);
         process.exit(1);
     }
 }
@@ -113,6 +145,7 @@ console.log(`[pm2me] Using database: ${dbPath}`);
 const server = spawn('node', ['app.js'], {
     cwd: backendDir,
     stdio: 'inherit',
+    windowsHide: true,
     env: {
         ...process.env,
         PORT: String(PORT),

package/package.json

@@ -1,59 +1,59 @@
-{
-  "name": "@drocketxx/pm2me",
-  "version": "1.1.1",
-  "description": "PM2 Deployment and Management System — Web UI for PM2 process management",
-  "type": "module",
-  "main": "backend/app.js",
-  "bin": {
-    "pm2me": "./bin/pm2me.js"
-  },
-  "files": [
-    "bin/",
-    "backend/",
-    "README.md"
-  ],
-  "dependencies": {
-    "bcrypt": "^6.0.0",
-    "connect-history-api-fallback": "^2.0.0",
-    "cors": "^2.8.6",
-    "dotenv": "^17.3.1",
-    "express": "^5.2.1",
-    "jsonwebtoken": "^9.0.3",
-    "lowdb": "^7.0.1",
-    "morgan": "^1.10.1",
-    "pm2": "^6.0.14",
-    "simple-git": "^3.32.3",
-    "socket.io": "^4.8.3"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/drocketxx/PM2Me.git"
-  },
-  "homepage": "https://github.com/drocketxx/PM2Me",
-  "keywords": [
-    "pm2",
-    "deploy",
-    "management",
-    "nginx",
-    "web-ui"
-  ],
-  "author": "drocketxx",
-  "license": "ISC",
-  "scripts": {
-    "dev:frontend": "cd frontend && npm run dev",
-    "dev:backend": "cd backend && npm run dev",
-    "dev:concurrent": "concurrently \"npm run dev:backend\" \"npm run dev:frontend\"",
-    "build": "cd frontend && npm run build",
-    "dev": "npm run build && cd backend && npm run dev",
-    "install:all": "npm install && cd frontend && npm install && cd ../backend && npm install",
-    "pw": "cd backend && node scripts/change-password.js",
-    "start": "node bin/pm2me.js"
-  },
-  "devDependencies": {
-    "concurrently": "^8.2.2",
-    "nodemon": "^3.1.14"
-  }
+{
+  "name": "@drocketxx/pm2me",
+  "version": "1.1.4",
+  "description": "PM2 Deployment and Management System — Web UI for PM2 process management",
+  "type": "module",
+  "main": "backend/app.js",
+  "bin": {
+    "pm2me": "./bin/pm2me.js"
+  },
+  "files": [
+    "bin/",
+    "backend/",
+    "README.md"
+  ],
+  "dependencies": {
+    "bcrypt": "^6.0.0",
+    "connect-history-api-fallback": "^2.0.0",
+    "cors": "^2.8.6",
+    "dotenv": "^17.3.1",
+    "express": "^5.2.1",
+    "jsonwebtoken": "^9.0.3",
+    "lowdb": "^7.0.1",
+    "morgan": "^1.10.1",
+    "pm2": "^6.0.14",
+    "simple-git": "^3.32.3",
+    "socket.io": "^4.8.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/drocketxx/PM2Me.git"
+  },
+  "homepage": "https://github.com/drocketxx/PM2Me",
+  "keywords": [
+    "pm2",
+    "deploy",
+    "management",
+    "nginx",
+    "web-ui"
+  ],
+  "author": "drocketxx",
+  "license": "ISC",
+  "scripts": {
+    "dev:frontend": "cd frontend && npm run dev",
+    "dev:backend": "cd backend && npm run dev",
+    "dev:concurrent": "concurrently \"npm run dev:backend\" \"npm run dev:frontend\"",
+    "build": "cd frontend && npm run build",
+    "dev": "npm run build && cd backend && npm run dev",
+    "install:all": "npm install && cd frontend && npm install && cd ../backend && npm install",
+    "pw": "cd backend && node scripts/change-password.js",
+    "start": "node bin/pm2me.js"
+  },
+  "devDependencies": {
+    "concurrently": "^8.2.2",
+    "nodemon": "^3.1.14"
+  }
 }