matterbridge 3.5.1-dev-20260122-6461be3 → 3.5.1-dev-20260123-4fcee18

package/CHANGELOG.md

@@ -39,6 +39,7 @@ Advantages:
 - [matter.js]: Bump to matter.j v. 0.16.6.
 - [mb_mdns]: Added --ip-filter params to filter incoming mDns messages by sender ip.
 - [express]: Added a login check for internal express api. Now only /health and /memory are opened. Thanks Rogibaer (https://github.com/Luligu/matterbridge-hass/issues/149).
+- [readme]: Added a section with the data structure and backup/restore guidelines.
 
 ### Changed
 

package/README.md

@@ -162,7 +162,13 @@ Here's how to specify a different port number:
 matterbridge --frontend [port number]
 ```
 
-To use the frontend with ssl see below.
+The frontend binds, by default, to all IPv4 and IPv6 addresses. You can override this and bind to a specific address:
+
+```bash
+matterbridge --bind [address]
+```
+
+To use the frontend with SSL, see below.
 
 From the frontend you can do all operations in an easy way.
 
@@ -551,6 +557,37 @@ So depending on the controller you pair with, you should see 100 for fully close
 
 Some controllers invert the position so you need to verify your controller.
 
+## Data structure
+
+Matterbridge uses three directories. These are the default locations (some advanced setups may change them, so check your configuration):
+
+```text
+~/.matterbridge
+~/Matterbridge
+~/.mattercert
+```
+
+### Backup
+
+From the frontend (three-dots menu), select **Create backup**, then **Download backup** when it is ready.
+The backup file is a standard `.zip` archive.
+
+### Restore
+
+Restore must be done manually because the archive paths depend on your setup.
+
+Make sure Matterbridge is not running. Stop it if needed.
+
+Extract the backup and replace the corresponding directories on your system with the ones from the backup:
+
+```text
+.matterbridge
+Matterbridge
+.mattercert
+```
+
+Ensure permissions are correct for the restored directories.
+
 # Known general issues
 
 ## Session XYZ does not exist or Cannot find a session for ID XYZ
@@ -567,17 +604,13 @@ All issues have been solved from the version 17.5 of the HomePod/AppleTV. Now th
 
 If you have more then one Apple TV or Home Pod, you can herve better results setting to disabled "Automatic Selection" in "Home Setting", "Home Hubs & Bridges". When "Automatic selection" is disabled, select your Apple Tv if you have one or any of your Home Pod. In this way you should not have anymore more then one session for fabric.
 
-### Manufacturer Serial Number and Model
-
-The Home app forgets about them when you restart the node.
-
 ### Appliances
 
 As of version 18.4.x, all Appliances device types are not supported by the Home app. They don't even appear like unsupported accessories.
 
 ### Robot
 
-As of version 18.4.x, the Robot is supported by the Home app only as a single, non-bridged device or if it is the only device in the bridge.
+As of version 18.4.x, the Robot is supported by the Home app only as a single, non-bridged device or if it is the only device in the bridge. Furthermore the device cannot be a composed device. The only device type supported is the rvc.
 
 If a Robot is present alongside other devices in the bridge, the entire bridge becomes unstable in the Home app.
 
@@ -591,7 +624,6 @@ So far is the only controller supporting all Matter 1.2, 1.3 and 1.4 device type
 
 - If HA doesn't show all devices, reload the Matter Server Integration or reboot HA
 - Home Assistant doesn't seem to always react when a device is removed from the bridge: they remain in HA unavailable forever. A full Home Assistant restart solves the problem.
-- Use Apple Home when you have to choose the controller type even if you pair Matterbridge directly with HA.
 
 ## Google Home
 
@@ -601,6 +633,8 @@ If you face a problem changing the brightness check this for the explanation: ht
 
 If you encounter a “Something Went Wrong” screen while commissioning MatterBridge devices in Google Home on Android, it’s due to an Android bug. Android fails to send the country code, which is mandatory under the Matter specification.
 
+There is also a known issue with the thermostat Fahrenheit to Celsius Conversion (https://github.com/Luligu/matterbridge/issues/462).
+
 ### Workaround
 
 Install Google Home on an iPhone and complete the commissioning there. Once set up, the devices will appear and function normally on your Android phone and other Nest devices in your home. By [Artem Kovalov](https://github.com/artemkovalyov).

package/dist/frontend.js

@@ -238,6 +238,8 @@ export class Frontend extends EventEmitter {
                         return socket.destroy();
                     }
                     this.log.debug(`WebSocket upgrade success host ${url.host} password ${password ? '[redacted]' : '(empty)'}`);
+                    if (req.socket.remoteAddress)
+                        this.authClients.push(req.socket.remoteAddress);
                     this.webSocketServer?.handleUpgrade(req, socket, head, (ws) => {
                         this.webSocketServer?.emit('connection', ws, req);
                     });
@@ -373,6 +375,8 @@ export class Frontend extends EventEmitter {
                         return socket.destroy();
                     }
                     this.log.debug(`WebSocket upgrade success host ${url.host} password ${password ? '[redacted]' : '(empty)'}`);
+                    if (req.socket.remoteAddress)
+                        this.authClients.push(req.socket.remoteAddress);
                     this.webSocketServer?.handleUpgrade(req, socket, head, (ws) => {
                         this.webSocketServer?.emit('connection', ws, req);
                     });
@@ -1484,7 +1488,7 @@ export class Frontend extends EventEmitter {
             else if (data.method === '/api/create-backup') {
                 this.wssSendSnackbarMessage('Creating backup...', 0);
                 this.log.notice(`Creating the backup...`);
-                await createZip(path.join(os.tmpdir(), `matterbridge.backup.zip`), path.join(this.matterbridge.matterbridgeDirectory), path.join(this.matterbridge.matterbridgePluginDirectory));
+                await createZip(path.join(os.tmpdir(), `matterbridge.backup.zip`), path.join(this.matterbridge.matterbridgeDirectory), path.join(this.matterbridge.matterbridgePluginDirectory), path.join(this.matterbridge.matterbridgeCertDirectory));
                 this.log.notice(`Backup ready to be downloaded.`);
                 this.wssSendCloseSnackbarMessage('Creating backup...');
                 this.wssSendSnackbarMessage('Backup ready to be downloaded', 10);

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "matterbridge",
-  "version": "3.5.1-dev-20260122-6461be3",
+  "version": "3.5.1-dev-20260123-4fcee18",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge",
-      "version": "3.5.1-dev-20260122-6461be3",
+      "version": "3.5.1-dev-20260123-4fcee18",
       "license": "Apache-2.0",
       "dependencies": {
         "@matter/main": "0.16.6",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge",
-  "version": "3.5.1-dev-20260122-6461be3",
+  "version": "3.5.1-dev-20260123-4fcee18",
   "description": "Matterbridge plugin manager for Matter",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",
@@ -118,8 +118,8 @@
     "ws": "8.19.0"
   },
   "build": {
-    "sha": "6461be3ccab30eba315d06587206f5ca5dcdc344",
-    "sha7": "6461be3",
+    "sha": "4fcee18598592191a42c1f07464efd96fbf0288f",
+    "sha7": "4fcee18",
     "event": "workflow_dispatch",
     "workflow": "Daily Dev Publish to npm",
     "type": "branch",