mb-service-linux 2.0.0 → 2.0.1-dev-20260701-117d561

package/CHANGELOG.md

@@ -24,7 +24,16 @@ If you like this project and find it useful, please consider giving it a star on
 
 <a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/assets/bmc-button.svg" alt="Buy me a coffee" width="120"></a>
 
-## [2.0.0] - Dev branch
+## [2.0.1] - Dev branch
+
+### Added
+
+- [service]: Add path of service file.
+- [service]: Add Environment PATH to the service file.
+
+<a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/assets/bmc-button.svg" alt="Buy me a coffee" width="80"></a>
+
+## [2.0.0] - 2026-07-01
 
 ### Added
 

package/README.md

@@ -55,8 +55,16 @@ See the complete guidelines on [Matterbridge](https://matterbridge.io) for more
 
 ## How to install the Matterbridge service cli
 
+Install it with Node.js:
+
+```bash
+sudo npm install mb-service-linux --global --omit=dev
+```
+
+Or install it with Bun:
+
 ```bash
-sudo npm install -g mb-service-linux --omit=dev
+bun add mb-service-linux --global --omit=dev
 ```
 
 Create a root-owned service file when Matterbridge is installed globally with npm:
@@ -67,7 +75,7 @@ sudo mb-service enable
 sudo mb-service start
 ```
 
-Create a user-owned service file when Matterbridge is installed for the current user:
+Create a user-owned service file when Matterbridge is installed for the current user with npm:
 
 ```bash
 mb-service create

package/dist/module.js

@@ -163,8 +163,8 @@ function printHelp() {
         `  Bun version: ${process.versions.bun ?? 'not running'}\n` +
         `  Running as root: ${isRoot() ? 'yes' : 'no'}\n` +
         `  Service user: ${getDiagnosticUser()}\n` +
-        `  Root service file: ${existsServiceFile(true) ? 'found' : 'not found'}\n` +
-        `  User service file: ${existsServiceFile(false) ? 'found' : 'not found'}\x1b[0m`);
+        `  Root service file: ${existsServiceFile(true) ? `found at "${getServicePath(true)}"` : 'not found'}\n` +
+        `  User service file: ${existsServiceFile(false) ? `found at "${getServicePath(false)}"` : 'not found'}\x1b[0m`);
     console.log(`Usage: mb-service [start|stop|restart|logs|status]\n\n` +
         `  Please provide a command:\n` +
         `    start                            start the matterbridge service\n` +
@@ -190,13 +190,19 @@ function createServiceConfig(root) {
         `Wants=network.target\n` +
         `StartLimitIntervalSec=60\n` +
         `StartLimitBurst=5\n` +
+        `\n` +
         `[Service]\n` +
         `Type=simple\n` +
+        `# PATH for any child process Matterbridge/plugins spawn (bun/node/npm lookups).\n` +
+        `Environment="PATH=/usr/local/bin:/usr/bin:/bin"\n` +
         `ExecStart=matterbridge --service\n` +
         `WorkingDirectory=%h\n` +
+        `# Logs go to the journal (should be persistent). Read with: journalctl -u matterbridge -n 1000 -f --output cat\n` +
         `StandardOutput=inherit\n` +
         `StandardError=inherit\n` +
         `Restart=always\n` +
+        `RestartSec=5\n` +
+        `TimeoutStopSec=60\n` +
         `User=${user}\n` +
         `Group=${user}\n` +
         `\n` +
@@ -208,13 +214,22 @@ function createServiceConfig(root) {
         `Wants=network.target\n` +
         `StartLimitIntervalSec=60\n` +
         `StartLimitBurst=5\n` +
+        `\n` +
         `[Service]\n` +
         `Type=simple\n` +
+        `# PATH for any child process Matterbridge/plugins spawn (bun/node/npm lookups).\n` +
+        (isBun() ? `Environment="PATH=%h/.bun/bin:/usr/local/bin:/usr/bin:/bin"\n` : `Environment="PATH=/usr/local/bin:/usr/bin:/bin"\n`) +
+        `# Absolute paths — systemd has no shell PATH. %h = the user's home.\n` +
+        `# --bun forces the Bun runtime even though the matterbridge bin has a node shebang,\n` +
+        `# and shims any \`node\` the process spawns to Bun as well.\n` +
         (isBun() ? `ExecStart=%h/.bun/bin/bun --bun run %h/.bun/bin/matterbridge --service\n` : `ExecStart=matterbridge --service\n`) +
         `WorkingDirectory=%h\n` +
+        `# Logs go to the journal (should be persistent). Read with: journalctl --user -u matterbridge -n 1000 -f --output cat\n` +
         `StandardOutput=inherit\n` +
         `StandardError=inherit\n` +
         `Restart=always\n` +
+        `RestartSec=5\n` +
+        `TimeoutStopSec=60\n` +
         `\n` +
         `[Install]\n` +
         `WantedBy=default.target\n`;

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "mb-service-linux",
-  "version": "2.0.0",
+  "version": "2.0.1-dev-20260701-117d561",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "mb-service-linux",
-      "version": "2.0.0",
+      "version": "2.0.1-dev-20260701-117d561",
       "license": "Apache-2.0",
       "bin": {
         "mb-service": "bin/mb-service"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mb-service-linux",
-  "version": "2.0.0",
+  "version": "2.0.1-dev-20260701-117d561",
   "description": "Matterbridge service command line interface",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",