MqDockerUp v2.0.0 π
A major release that fixes multi-container / multi-host support and adds a container whitelist. It contains breaking changes to how entities are published to Home Assistant β please read the upgrade notes below before updating.
β οΈ Breaking Changes
MQTT topics and Home Assistant entity identities are now based on the container name instead of the image (#645).
Previously every entity's MQTT topic, unique_id and device identifiers were derived from the container's image. Running several containers from the same image β or the same image across multiple hosts β made them collide and overwrite each other, so only one container showed up in Home Assistant. They are now based on the container name (optionally prefixed via MAIN_PREFIX), so each container gets its own device and entities.
What happens when you upgrade
- On first start, v2.0.0 runs a one-time automatic migration that clears the old image-based discovery topics. Home Assistant removes the stale entities and they are republished under the new container-based names β no manual broker cleanup is needed for the entities.
- Because entity
unique_ids change, any automations, scripts, dashboards or history that referenced the old entity IDs must be updated to the new ones. - Multi-host setups: give each host a unique
MAIN_PREFIXso containers with the same name on different hosts stay distinct.
β¨ New Features
Container monitor / whitelist (#644). List only the containers you want monitored instead of denylisting everything else:
MONITOR_CONTAINERSβ only these containers are monitored.MONITOR_UPDATESβ only these containers are checked for updates.- Per-container labels
mqdockerup.monitor_container/mqdockerup.monitor_updates. - Leave empty (or
*) to keep the default of monitoring everything. Existingignorerules still take precedence.
π§ Maintenance
- Centralized MQTT topic/identity generation into a new
TopicService. - Migrated the database driver from
sqlite3tobetter-sqlite3(same SQLite data file, no data loss) and updated dependencies;npm auditis now clean.
What's Changed
π Features
- Add monitor (whitelist) configuration by @MichelFR in #644
- Key MQTT topics and HA identities off the container name by @MichelFR in #645
π Dependencies π¦
- Bump actions/checkout from 6 to 7 by @dependabot[bot] in #642
Full Changelog: v1.23.8...v2.0.0