matterbridge 3.5.3 → 3.5.4-dev-20260211-c4f9359

package/CHANGELOG.md

@@ -47,6 +47,50 @@ Advantages:
 - individual plugin isolation in childbridge mode;
 - ability to update the plugin in childbridge mode without restarting matterbridge;
 
+## [3.5.4] - Dev branch
+
+### Dev Breaking Changes
+
+- [exports]: Removed Matterbridge export.
+
+### Breaking Changes
+
+- [doorLock]: The default value for actuatorEnabled has been changed to true. Thanks Ludovic BOUÉ (https://github.com/Luligu/matterbridge/pull/509).
+
+### Added
+
+- [packages]: Added @matterbridge/types monorepo scoped package.
+- [packages]: Added @matterbridge/core monorepo scoped package.
+- [apps]: Added @matterbridge/frontend monorepo scoped package.
+
+### Changed
+
+- [package]: Updated dependencies.
+- [matterbridge.io]: Updated docs.
+- [docker]: Updated docker readme file to clarify which base image is used.
+- [frontend]: Bumped `frontend` version to v. 3.4.5.
+
+### Fixed
+
+- [worflows]: Fixed workflows that failed and dockerfiles.
+- [childbridge]: Fixed sequence of disabling a plugin in childbridge mode. Thanks [Tamer Salah](https://github.com/tammeryousef1006).
+
+### Security
+
+During installation you may see a warning that looks scary, for example:
+
+```text
+npm warn deprecated glob@10.5.0: Old versions of glob are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me
+```
+
+This warning does not come from Matterbridge code.
+
+It is emitted by a transitive dependency (the `archiver` package) that pulls in an older `glob` version. Matterbridge does not depend on this version of `glob` directly.
+
+In short: you can safely ignore this message; it is a dependency warning, not a Matterbridge vulnerability.
+
+<a href="https://www.buymeacoffee.com/luligugithub"><img src="https://matterbridge.io/assets/bmc-button.svg" alt="Buy me a coffee" width="80"></a>
+
 ## [3.5.3] - 2026-02-06
 
 ### Dev Breaking Changes

package/README-DEV.md

@@ -91,7 +91,7 @@ Matterbridge exports from:
 
 ### "matterbridge"
 
-- Matterbridge and all Matterbridge related classes.
+- Matterbridge related classes needed in a plugin.
 
 ### "matterbridge/devices"
 
@@ -99,7 +99,7 @@ Matterbridge exports from:
 
 ### "matterbridge/clusters"
 
-- All clusters not present in matter.js or modified.
+- All clusters not present in matter.js or modified. It can be empty.
 
 ### "matterbridge/utils"
 

package/README-DOCKER.md

@@ -25,13 +25,19 @@
 
 The Matterbridge Docker images (multi-arch manifest list for **linux/amd64** and **linux/arm64**) are published on [**Docker Hub**](https://hub.docker.com/r/luligu/matterbridge). If you use them, please consider starring the project on [**Docker Hub**](https://hub.docker.com/r/luligu/matterbridge).
 
-The image (tag **latest**) includes Matterbridge and all official plugins, using the latest release published on npm. It is based on `node:24-trixie-slim`. Since all official plugins are included, you can select and add a plugin without installing anything.
+The image (tag **latest** 92 MB) includes Matterbridge and all official plugins, using the latest release published on npm. It is based on `node:24-trixie-slim`. Since all official plugins are included, you can select and add a plugin without installing anything.
 
-The image (tag **dev**) includes Matterbridge and all official plugins from the latest push on GitHub. It is based on `node:24-trixie-slim`. Since all official plugins are included, you can select and add a plugin without installing anything. Note: if you update to the latest **dev** from the frontend, you will override the GitHub version with the latest **dev** published on npm. The frontend shows if you are currently running the GitHub release or the latest or dev npm release.
+The image (tag **dev** 93 MB) includes Matterbridge and all official plugins from the latest push on GitHub. It is based on `node:24-trixie-slim`. Since all official plugins are included, you can select and add a plugin without installing anything. Note: if you update to the latest **dev** from the frontend, you will override the GitHub version with the latest **dev** published on npm. The frontend shows if you are currently running the GitHub release or the latest or dev npm release.
 
-The image (tag **ubuntu**) includes only Matterbridge, using the latest release published on npm. This image (**for test and development only**) is based on `ubuntu:latest` with Node.js 24 from NodeSource. Plugins are not included in the image; they will be installed on first run. This image preinstalls `bluetooth`, `build-essential`, and `python` packages (useful for plugins that require native builds).
+The image (tag **ubuntu** 90 MB) includes only Matterbridge, using the latest release published on npm. This image (**for test and development only**) is based on `ubuntu:latest` with Node.js 24 from NodeSource. Plugins are not included in the image; they will be installed on first run. This image preinstalls `bluetooth`, `build-essential`, and `python` packages (useful for plugins that require native builds).
 
-The image (tag **alpine**) includes only Matterbridge, using the latest release published on npm. This image (**for test and development only**) is based on `node:24-alpine`. Plugins are not included in the image; they will be installed on first run.
+The image (tag **alpine** 58 MB) includes only Matterbridge, using the latest release published on npm. This image (**for test and development only**) is based on `node:24-alpine`. Plugins are not included in the image; they will be installed on first run.
+
+### Matterbridge docker base images
+
+The image (tag **24-ubuntu-slim** 86 MB) includes only `ubuntu:latest` -> Ubuntu 24.04.3 LTS (noble) with Node.js 24 from NodeSource. It is used to build the **ubuntu** image but can also be used to open a shell in ubuntu latest with node 24.
+
+The image (tag **s6-rc-base** 84 MB) includes only Matterbridge, using the latest release published on npm. This image is based on `node:24-trixie-slim` and integrates the s6-rc overlay system. Plugins are not included in the image; they will be installed on first run. It is used like base image for the [Matterbridge Home Assistant Application](https://github.com/Luligu/matterbridge-home-assistant-addon).
 
 ### Docker health check
 
@@ -78,6 +84,7 @@ After adding your user to the `docker` group, log out and log back in so your cu
 The container must have full access to the host network (needed for mDNS and the Matter protocol).
 
 ```bash
+sudo docker pull luligu/matterbridge:latest
 sudo docker run --name matterbridge \
   -v ~/Matterbridge:/root/Matterbridge \
   -v ~/.matterbridge:/root/.matterbridge \
@@ -90,6 +97,7 @@ You may need to adapt the paths to your setup.
 ### Run the container with extra parameters (e.g. frontend on port 8585)
 
 ```bash
+sudo docker pull luligu/matterbridge:latest
 sudo docker run --name matterbridge \
   -v ~/Matterbridge:/root/Matterbridge \
   -v ~/.matterbridge:/root/.matterbridge \
@@ -124,12 +132,14 @@ Copy it to your home directory or edit your existing compose file to add the Mat
 Then start Docker Compose with:
 
 ```bash
+docker compose pull matterbridge
 docker compose up -d
 ```
 
 Or start only the Matterbridge container with:
 
 ```bash
+docker compose pull matterbridge
 docker compose up -d matterbridge
 ```
 

package/README.md

@@ -219,7 +219,7 @@ or with user matterbridge and with private global node_modules and npm cache (no
 
 ### Run matterbridge as an home assistant add-on with the official add-on
 
-[Home assistant add-on configuration](https://github.com/Luligu/matterbridge-home-assistant-addon)
+[Home assistant application (formerly known as add-on) configuration](https://github.com/Luligu/matterbridge-home-assistant-addon)
 
 ### Other Home Assistant Community Add-ons