Skip to content

v2.0.0

Latest

Choose a tag to compare

@github-actions github-actions released this 20 Jun 12:34

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_PREFIX so 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. Existing ignore rules still take precedence.

πŸ”§ Maintenance

  • Centralized MQTT topic/identity generation into a new TopicService.
  • Migrated the database driver from sqlite3 to better-sqlite3 (same SQLite data file, no data loss) and updated dependencies; npm audit is 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 πŸ“¦

Full Changelog: v1.23.8...v2.0.0

πŸ“Œ Direct Commits