refactor: remove PM2 dependency, add universal process manager support

Replace PM2-specific restart/stop logic with universal approach:
- Desktop mode (Electron): app.relaunch() + app.quit()
- Server mode: process.exit(0) for clean restart, exit(1) for stop
- Wait for HTTP response via res.on('finish') before exit

Changes:
- Add handleRestart() and handleStop() replacing controlPm2()
- Fix shutdown/reboot: detect sudo password errors, show helpful message
- Update translations: RESTART→REBOOT, add CONFIRM_RESTARTMM
- Improve MINIMIZE hint: "restart to restore" instead of "cannot undo"
- Add missing translation keys (FULLSCREEN, MINIMIZE, DEVTOOLS)
- Update docs (README, FAQ with sudo setup guide, swagger.json)
- Remove all PM2 references from code and documentation
- Add error logging in catch blocks for better debugging

The `pm2ProcessName` config option is no longer used (silently ignored).
Restart now works automatically with any process manager (systemd, PM2,
Docker, etc.) configured to restart on exit code 0.

Author: KristjanESPERANTO

README.md

@@ -89,7 +89,7 @@ The module also includes a **RESTful API** for controlling all aspects of your m
    ipWhitelist: ["127.0.0.1", "::ffff:127.0.0.1", "::1", "::ffff:192.168.0.1/120", "192.168.0.1/24"],
    ```
 
-4. Restart your MagicMirror² (i.e. `pm2 restart MagicMirror`).
+4. Restart MagicMirror².
 
 5. Access the remote interface on [http://192.168.xxx.xxx:8080/remote.html](http://192.168.xxx.xxx:8080/remote.html) (replace with IP address of your RaspberryPi).
 
@@ -149,15 +149,15 @@ For example you can use [MMM-ModuleScheduler](https://forum.magicmirror.builders
 
 ### Examples
 
-- Example for a REST API GET request to trigger a RaspberryPi restart:
+- Example for a REST API GET request to trigger a system reboot:
 
-`http://192.168.xxx.xxx:8080/api/restart`
+  `http://192.168.xxx.xxx:8080/api/reboot`
 
-- Example to trigger a RaspberryPi restart in your module:
+- Example to trigger MagicMirror² restart in your module:
 
-```js
-this.sendNotification("REMOTE_ACTION", { action: "RESTART" });
-```
+  ```js
+  this.sendNotification("REMOTE_ACTION", { action: "RESTART" });
+  ```
 
 See the [Examples Guide](docs/guide/examples.md) for more integration examples with MMM-ModuleScheduler, MMM-Navigate, Home Assistant, and more.
 
@@ -178,19 +178,20 @@ See the [Examples Guide](docs/guide/examples.md) for more integration examples w
 
 |   Action   | Description                                                                                                                                                     |
 | :--------: | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-|  RESTART   | Restart your MagicMirror²                                                                                                                                       |
+|  RESTART   | Restart MagicMirror² (Electron relaunch or clean process exit for process managers like systemd/PM2/Docker)                                                     |
+|    STOP    | Stop MagicMirror² without restarting (exits with error code, process managers won't auto-restart)                                                               |
 |  REFRESH   | Refresh mirror page                                                                                                                                             |
 |   UPDATE   | Update MagicMirror² and any of it's modules                                                                                                                     |
 |    SAVE    | Save the current configuration (show and hide status of modules, and brightness), will be applied after the mirror starts                                       |
 | BRIGHTNESS | Change mirror brightness, with the new value specified by `value`. `100` equals the default (full brightness), possible range is between `0` (black) and `100`. |
 
 #### MagicMirror² Electron Browser Window Control
 
-|      Action      | Description                        |
-| :--------------: | ---------------------------------- |
-|     MINIMIZE     | Minimize the browser window.       |
-| TOGGLEFULLSCREEN | Toggle fullscreen mode on and off. |
-|     DEVTOOLS     | Open the DevTools console window.  |
+|      Action      | Description                                                                                 |
+| :--------------: | ------------------------------------------------------------------------------------------- |
+|     MINIMIZE     | Minimize the browser window. **Warning:** Cannot be undone via remote (Wayland limitation). |
+| TOGGLEFULLSCREEN | Toggle fullscreen mode on and off.                                                          |
+|     DEVTOOLS     | Open the DevTools console window.                                                           |
 
 #### Module Control
 

cspell.config.json

@@ -52,6 +52,7 @@
     "navicon",
     "newsfeed",
     "newsitems",
+    "NOPASSWD",
     "Norsk",
     "openmeteo",
     "passwordless",

docs/guide/configuration.md

@@ -92,16 +92,6 @@ config: {
 },
 ```
 
-### pm2ProcessName
-
-If your PM2 process name is not the default `mm`:
-
-```js
-config: {
-    pm2ProcessName: 'MagicMirror',
-},
-```
-
 ## Position
 
 Setting a `position` displays the mirror's IP address on screen. You can hide it later from the module menu.

docs/guide/faq.md

@@ -2,23 +2,39 @@
 
 ## System Issues
 
-### RPi not shutting down? Getting "Interactive Authorization" error
+### Shutdown or Reboot not working? "System requires password" error
 
-You need passwordless sudo for shutdown commands. See [this guide](https://askubuntu.com/questions/168879/shutdown-from-terminal-without-entering-password).
+Your system requires a password for shutdown/reboot commands. To fix this:
 
-### MagicMirror instance isn't restarting
+1. Open the sudoers file (safely):
+
+   ```bash
+   sudo visudo
+   ```
 
-You probably don't have PM2 installed, or the process name is different.
+2. Add this line at the end (replace `pi` with your username):
 
-1. Check if PM2 is running: `pm2 list`
-2. If your process name isn't `mm`, add to config:
-   ```js
-   config: {
-       pm2ProcessName: 'MagicMirror',  // your process name
-   }
+   ```bash
+   pi ALL=(ALL) NOPASSWD: /sbin/shutdown
    ```
 
-See [MagicMirror Docs](https://docs.magicmirror.builders/configuration/autostart.html) for PM2 setup.
+3. Save and exit (Ctrl+X, then Y, then Enter)
+
+Now shutdown and reboot should work without password prompts.
+
+See also: [Ubuntu guide on passwordless shutdown](https://askubuntu.com/questions/168879/shutdown-from-terminal-without-entering-password)
+
+### MagicMirror instance isn't restarting
+
+The restart function depends on your process manager setup.
+
+1. In Desktop mode (with Electron), restart uses `app.relaunch()` and `app.quit()`
+2. In Server mode, the process exits cleanly and your process manager (systemd, PM2, Docker, etc.) should restart it
+3. Make sure your process manager is configured to restart on clean exit (exit code 0)
+
+For example, with systemd set `Restart=on-success`, or with PM2 use the default auto-restart behavior.
+
+See [MagicMirror Docs](https://docs.magicmirror.builders/configuration/autostart.html) for setup instructions.
 
 ---
 

docs/swagger.json

@@ -459,7 +459,7 @@
     "/api/restart": {
       "get": {
         "tags": ["Mirror Control", "API"],
-        "summary": "Restart your MagicMirror² instance if using PM2 to control it.",
+        "summary": "Restart your MagicMirror² instance (Electron relaunch or process manager restart).",
         "security": [
           {
             "apikey": []
@@ -623,11 +623,11 @@
                     "MONITOROFF": "Turn monitor OFF",
                     "MONITORON": "Turn monitor ON",
                     "MONITORTIMED": "Turn monitor ON briefly",
-                    "RESTART": "Restart",
+                    "REBOOT": "Reboot System",
                     "RESTARTMM": "Restart MagicMirror²",
                     "SHUTDOWN": "Shutdown",
                     "FULLSCREEN": "Toggle Fullscreen",
-                    "MINIMIZE": "Minimize Browser",
+                    "MINIMIZE": "Minimize Browser (restart to restore)",
                     "DEVTOOLS": "Open DevTools",
                     "SHOWALL": "All",
                     "HIDEALL": "All",
@@ -658,7 +658,8 @@
                     "PANIC": "Never mind.",
                     "NO_RISK_NO_FUN": "No risk no fun!",
                     "CONFIRM_SHUTDOWN": "The system will shut down.",
-                    "CONFIRM_RESTART": "The system will restart.",
+                    "CONFIRM_REBOOT": "The system will restart.",
+                    "CONFIRM_RESTARTMM": "MagicMirror² will restart.",
                     "LOAD_ERROR": "If you see this message, an error occurred when loading the javascript file. Please go to the following link and see if this a known problem with your browser:",
                     "ISSUE_LINK": "Github issue page",
                     "DONE": "Done.",

node_helper.js

@@ -790,18 +790,46 @@ module.exports = NodeHelper.create({
     }
   },
 
-  shutdownControl (action, options) {
+  shutdownControl (action, options, res) {
     const shutdownCommand = this.initialized && "shutdownCommand" in this.thisConfig.customCommand
       ? this.thisConfig.customCommand.shutdownCommand
       : "sudo shutdown -h now";
     const rebootCommand = this.initialized && "rebootCommand" in this.thisConfig.customCommand
       ? this.thisConfig.customCommand.rebootCommand
       : "sudo shutdown -r now";
     if (action === "SHUTDOWN") {
-      exec(shutdownCommand, options, (error, stdout, stderr, res) => { this.checkForExecError(error, stdout, stderr, res); });
+      this.sendResponse(res, undefined, {action: "SHUTDOWN", info: "Shutting down system..."});
+      Log.log(`Executing shutdown command: ${shutdownCommand}`);
+      exec(shutdownCommand, options, (error, stdout, stderr) => {
+        if (error) {
+          // Check for sudo password requirement
+          if (error.killed && error.signal === "SIGTERM") {
+            Log.error("Shutdown failed: System requires password for shutdown.");
+            Log.error("See setup guide: https://github.com/Jopyth/MMM-Remote-Control#faq");
+            return;
+          }
+          Log.error(`Shutdown error: ${stderr || error.message}`);
+        } else {
+          Log.log("Shutdown command executed successfully - system should be shutting down...");
+        }
+      });
     }
     if (action === "REBOOT") {
-      exec(rebootCommand, options, (error, stdout, stderr, res) => { this.checkForExecError(error, stdout, stderr, res); });
+      this.sendResponse(res, undefined, {action: "REBOOT", info: "Rebooting system..."});
+      Log.log(`Executing reboot command: ${rebootCommand}`);
+      exec(rebootCommand, options, (error, stdout, stderr) => {
+        if (error) {
+          // Check for sudo password requirement
+          if (error.killed && error.signal === "SIGTERM") {
+            Log.error("Reboot failed: System requires password for reboot.");
+            Log.error("See setup guide: https://github.com/Jopyth/MMM-Remote-Control#faq");
+            return;
+          }
+          Log.error(`Reboot error: ${stderr || error.message}`);
+        } else {
+          Log.log("Reboot command executed successfully - system should be rebooting...");
+        }
+      });
     }
   },
 
@@ -915,6 +943,49 @@ module.exports = NodeHelper.create({
     }
   },
 
+  handleRestart (query, res) {
+    try {
+      const {app} = require("electron");
+      if (!app) { throw "Could not get Electron app instance."; }
+      this.sendResponse(res, undefined, {action: "RESTART", info: "Restarting Electron..."});
+      app.relaunch();
+      app.quit();
+    } catch (error) {
+      // Electron not available (server mode) - exit cleanly and let process manager restart
+      Log.log(`Electron not available (${error?.message || "server mode"}), exiting process for restart by process manager...`);
+      this.sendResponse(res, undefined, {action: "RESTART", info: "Exiting process for restart..."});
+
+      // Wait for response to be sent before exiting
+      if (res && res.on) {
+        res.on("finish", () => {
+          // eslint-disable-next-line unicorn/no-process-exit
+          process.exit(0);
+        });
+      } else {
+        // Fallback if res doesn't have event emitter (socket response)
+        // eslint-disable-next-line unicorn/no-process-exit
+        setTimeout(() => process.exit(0), 1000);
+      }
+    }
+  },
+
+  handleStop (query, res) {
+    Log.log("Stopping MagicMirror...");
+    this.sendResponse(res, undefined, {action: "STOP", info: "Stopping process..."});
+
+    // Wait for response to be sent before exiting
+    if (res && res.on) {
+      res.on("finish", () => {
+        // eslint-disable-next-line unicorn/no-process-exit
+        process.exit(1);
+      });
+    } else {
+      // Fallback if res doesn't have event emitter (socket response)
+      // eslint-disable-next-line unicorn/no-process-exit
+      setTimeout(() => process.exit(1), 1000);
+    }
+  },
+
   handleCommand (query, res) {
     const options = {timeout: 15_000};
     if (this.thisConfig.customCommand && this.thisConfig.customCommand[query.command]) {
@@ -990,8 +1061,8 @@ module.exports = NodeHelper.create({
       GET_CHANGELOG: (q, r) => this.answerGetChangelog(q, r),
       SHUTDOWN: (q, r) => this.shutdownControl(q.action, options, r),
       REBOOT: (q, r) => this.shutdownControl(q.action, options, r),
-      RESTART: (q, r) => this.controlPm2(r, q),
-      STOP: (q, r) => this.controlPm2(r, q),
+      RESTART: (q, r) => this.handleRestart(q, r),
+      STOP: (q, r) => this.handleStop(q, r),
       COMMAND: (q, r) => this.handleCommand(q, r),
       USER_PRESENCE: (q, r) => this.handleUserPresence(q, r),
       MONITORON: (q, r) => this.monitorControl(q.action, options, r),
@@ -1158,57 +1229,6 @@ module.exports = NodeHelper.create({
     this.sendResponse(res, error, data);
   },
 
-  controlPm2 (res, query) {
-    const actionName = query.action.toLowerCase();
-
-    // Check if PM2 is available
-    try {
-      require.resolve("pm2");
-    } catch {
-      // PM2 not installed
-      const message = `MagicMirror² is not running under PM2. Please ${actionName} manually.`;
-      Log.log(`${message}`);
-      this.sendResponse(res, undefined, {action: actionName, info: message, status: "info"});
-      return;
-    }
-
-    const pm2 = require("pm2");
-    const processName = query.processName || this.thisConfig.pm2ProcessName || "mm";
-
-    pm2.connect((error) => {
-      if (error) {
-        pm2.disconnect();
-        const message = `MagicMirror² is not running under PM2. Please ${actionName} manually.`;
-        Log.log(`${message}`);
-        this.sendResponse(res, undefined, {action: actionName, info: message, status: "info"});
-        return;
-      }
-
-      // Check if process is running in PM2
-      pm2.list((error, list) => {
-        if (error || !list.some((proc) => proc.name === processName && proc.pm2_env.status === "online")) {
-          pm2.disconnect();
-          const message = `MagicMirror² is not running under PM2. Please ${actionName} manually.`;
-          Log.log(`${message}`);
-          this.sendResponse(res, undefined, {action: actionName, info: message, status: "info"});
-          return;
-        }
-
-        // Process is running in PM2, perform action
-        pm2[actionName](processName, (error) => {
-          pm2.disconnect();
-          if (error) {
-            Log.error(`PM2 ${actionName} error:`, error);
-            this.sendResponse(res, error);
-          } else {
-            Log.log(`PM2 ${actionName}: ${processName}`);
-            this.sendResponse(res, undefined, {action: actionName, processName});
-          }
-        });
-      });
-    });
-  },
-
   translate (data) {
     for (const t of Object.keys(this.translation)) {
       const pattern = `%%TRANSLATE:${t}%%`;

remote.html

@@ -120,7 +120,7 @@
             </div>
             <div id="restart-button" class="button" role="button" tabindex="0">
               <span class="fa fa-fw fa-refresh" aria-hidden="true"></span>
-              <span class="text">%%TRANSLATE:RESTART%%</span>
+              <span class="text">%%TRANSLATE:REBOOT%%</span>
             </div>
             <div
               id="restart-mm-button"