matterbridge 3.4.3-dev-20251207-3ce5a0e → 3.4.3-dev-20251208-0c8a552

package/CHANGELOG.md

@@ -33,6 +33,7 @@ Advantages:
 ### Added
 
 - [frontend]: Added homepage icon and link to https://matterbridge.io/.
+- [matterbridge]: Added more frontend messages on start when a plugin is in error state. It is more clear when the bridge will not start for plugin errors.
 
 ### Changed
 
@@ -43,7 +44,7 @@ Advantages:
 - [frontend]: Changed changelog link to https://matterbridge.io/CHANGELOG.html.
 - [frontend]: Changed changelog icon to HistoryOutlinedIcon.
 - [frontend]: Removed column Url from Devices panel in the Home page. It is available on the Devices page.
-- [frontend]: Mobile mode starts below 1200 x 900 and is fully responsive till a width of 340 pixel.
+- [frontend]: Mobile mode starts below 1200 x 900 and is fully resizable and responsive till a width of 360 pixel.
 
 ### Fixed
 

package/README.md

@@ -499,6 +499,16 @@ Then, from the dots menu in the frontend, download the `matterbridge.log` and `m
 
 Don't forget to unselect the debug mode when is no more needed. The network traffic and cpu usage is very high in debug mode.
 
+## Race condition on start / restart
+
+We have a race condition when, after a blackout or with docker compose or with other systems that start more then one process, Matterbridge starts before other required system or network components.
+
+Race condition can cause missing configuration or missed devices on the controller side. All Matterbridge official plugins already wait for system and network components to be ready so there is no need of delay.
+
+To solve the race condition on blackout, use the --delay parameter. There is no delay on normal restart cause the delay is applied only in the first 5 minutes from system reboot.
+
+To solve the race condition on docker compose, use the --fixed_delay parameter. The start will always be delayed.
+
 # Known general issues
 
 ## Session XYZ does not exist or Cannot find a session for ID XYZ

package/dist/matterbridge.js

@@ -1149,6 +1149,10 @@ export class Matterbridge extends EventEmitter {
         this.log.debug('Starting start matter interval in bridge mode...');
         let failCount = 0;
         this.startMatterInterval = setInterval(async () => {
+            if (failCount && failCount % 10 === 0) {
+                this.frontend.wssSendSnackbarMessage(`The bridge is still starting...`, 10, 'info');
+                this.frontend.wssSendRefreshRequired('plugins');
+            }
             for (const plugin of this.plugins) {
                 if (!plugin.enabled)
                     continue;
@@ -1160,6 +1164,8 @@ export class Matterbridge extends EventEmitter {
                     this.log.error('The bridge will not start until the problem is solved to prevent the controllers from deleting all registered devices.');
                     this.log.error('If you want to start the bridge disable the plugin in error state and restart.');
                     this.frontend.wssSendSnackbarMessage(`The plugin ${plugin.name} is in error state. Check the logs.`, 0, 'error');
+                    this.frontend.wssSendSnackbarMessage(`The bridge is offline. Startup halted due to plugin errors.`, 0, 'error');
+                    this.frontend.wssSendRefreshRequired('plugins');
                     return;
                 }
                 if (!plugin.loaded || !plugin.started) {
@@ -1225,6 +1231,10 @@ export class Matterbridge extends EventEmitter {
         this.log.debug('Starting start matter interval in childbridge mode...');
         let failCount = 0;
         this.startMatterInterval = setInterval(async () => {
+            if (failCount && failCount % 10 === 0) {
+                this.frontend.wssSendSnackbarMessage(`The bridge is still starting...`, 10, 'info');
+                this.frontend.wssSendRefreshRequired('plugins');
+            }
             let allStarted = true;
             for (const plugin of this.plugins.array()) {
                 if (!plugin.enabled)
@@ -1237,6 +1247,8 @@ export class Matterbridge extends EventEmitter {
                     this.log.error('The bridge will not start until the problem is solved to prevent the controllers from deleting all registered devices.');
                     this.log.error('If you want to start the bridge disable the plugin in error state and restart.');
                     this.frontend.wssSendSnackbarMessage(`The plugin ${plugin.name} is in error state. Check the logs.`, 0, 'error');
+                    this.frontend.wssSendSnackbarMessage(`The bridge is offline. Startup halted due to plugin errors.`, 0, 'error');
+                    this.frontend.wssSendRefreshRequired('plugins');
                     return;
                 }
                 this.log.debug(`Checking plugin ${plg}${plugin.name}${db} to start matter in childbridge mode...`);