CHANGELOG 1.8.5 Initial clean of MQTT topic on startup to remove any hanging in-progress status Default max summary size now 6K Truncation now logged 1.8.4 Release Info Default max summary size now 8K, to avoid Home Assistant warnings on state This limit can be increased, or removed, if the Update entities are excluded from Home Assistant’s state history 1.8.3 Release Info Release summaries can now have a max length, using release_summary_max_size, default 16k 1.8.2 Version Detection Tighten up auto and fallback rules for cases where digests don’t match Use versions in tag where they are SemVer or casual versions CLI Added dump=csv, dump=json and help commands Common Packages Added EMQX, Mosquitto, Plex, Emby, Tailscale, AppWrite, Traefik, Grafana, Prometheus, WhatsUpDocker, Lychee and HomeAssistant 1.8.1 Home Assistant Re-publish state every scan to ensure fresh Main discovery and state message now better in sync on in_progress flag State not published during update if Home Assistant mode off Version Detection Version Policy now includes TIMESTAMP for image creation date/time, which is also now part of auto version algorithm Version policy can be also be set in custom_packages.yaml or in the packages section of config Detect common mis-configuration where ubuntu base layer version published as derived image version MQTT MQTT result code, MID and publish status logged at debug, and at warning if non-success result code 1.8.0 Package Info The common_packages.yaml that ships inside the Docker image can be extended, or overridden, using the packages section of the main config file Source platform will be inferred, and verified, for GitHub, Gitlab, Quay, LSCR and Codeberg Release Notes If the component tag doesn’t match the release tag (e.g. 1.7.3 vs v1.7.3), an alt lookup will be made on latest github released, and used if the tag name on that release matches the expected tag, with a common v,V,r or R prefix A GitHub personal access token can now be added in the github: config section, which will increase number of API calls that can be made for release info before being throttled Release notes can be better guessed, subject to URL validation, for Gitlab and GitHub CLI Logging improved, with different default for container lookup, so there’s always some output from commands Added a tags option to retrieve list of known tags in the registry Housekeeping MQTT topic clean overhauled - Now runs only after scan Checks topics against current discoveries vs previous session key based check 1.7.3 Minor fix for stats reporting 1.7.2 API Stats OCI v2 API client maintains api stats per host, and errors per status code, with a cache hit ratio and avg elapsed time Container Registry Checks The Config document is now also pulled in, which means more images have annotations, nice versions and release notes OCI_V2_MINIMAL option to make only the calls needed for version checksDiagnostic code now distinguishes two ways that different digests are checked between old and new Stats now tallied for all registry URL calls, and periodically logged CLI Fixed issues with docker.io fetches Colourful and jq friendly JSON output Log level now defaults to WARNING to make it easier to pipe results to jq, can change to see headers using log_level=DEBUG 1.7.1 No code change, version changed to fix a pypi publish issue 1.7.0 py3.14 Image now built with python 3.14 by default Tests update for py3.14 mock async changes OCI Container Registry APIs By default now uses the OCI v2 Distribution APIs rather than old Docker APIs via Docker SDK Older method can be switched back on using docker.registry.api: docker_client configuration Container registry also used where available to pull in annotations ( including a meaningful version ) using the OCI Distriubtion API Docker, GitHub GHCR, Gitlab, LSCR, Microsoft MCR and Codeberg configured Authentication logic to automatically adapt and retry dynamically for other platforms Annotations will be sourced from the Index or Manifest, with priority for the (platform-specific) manifest Digest matching adapts to different practices across repos Registries can now be selectively included/excluded using registry_select in Docker configuration section GitHub Release Enrichment Where an annotation points to a source URL and hash, this can be used to derive a diff_url, a direct link to the actual release notes, and a release summary pulled from the Github source repo releases and passed onto Home Assistant A token can be provided, e.g. a Personal Access Token, at container level using UPD2MQTT_REGISTRY_TOKEN Common packages now have a source_repo_url and don’t need a release notes URL too if on GitHub Version Policies Version policies available to make use of meaningful versions from annotations AUTO will detect what looks like a SemVer and report only the meaningful version to HAVERSION,DIGEST and VERSION_DIGEST can be used to fix on which fields to useIf the chosen option isn’t available, next preference is for version:digest qualified version, falling back to whatever else is available Version policy can be set at container level using UPD2MQTT_VERSION_POLICY env var or corresponding label Version selection now has a diagnostic code, version_basis, that ties back to precisely which code used Local Docker Image Enrichment Metadata from local org.opencontainers labels published where available Added more packages to common-packages, vector and greptime Selective Home Assistant Discovery New version_select option in Docker config works like image_ref_select using the reported version instead Pinned Digests Better handling of tags with a pinned digest, e.g. ghcr.io/immich-app/postgres:14-vectorchord0.4.3-pgvectors0.2.0@sha256:41eacbe83eca995561fe43814fd4891e16e39632806253848efaf04d3c8a8b84 API Throttling Throttling fixed for TTL taken from remote API Docker provider shuffles the list of containers it scans so if there is aggressive throttling there isn’t the same set of containers always getting scanned before the rate limit hits Caching Index and Manifest local cache age now reported on MQTT message Additional logging and defaults for caching Local cache TTL override can be removed by using None for cache_ttl in registry config 1.6.0 MQTT Topics Separated out generic and Home Assistant specific topics The State , Command and Discovery topics are strictly Home Assistant schema The full discovery attributes are now published on their own topic This can also be supplied as additional attributes to the Home Assistant Update entity These can be turned off using the extra_attributes flag in homeassistant config Selective Home Assistant Discovery New image_ref_select option in Docker config List of include strings or regular expressions, containers which don’t match these won’t be Home Assistant discoverable List of exclude strings or regular expressions, containers which match these won’t be Home Assistant discoverable Containers not selected because of image_ref_select can still have an Auto update policy, so will be updated but not visible to Home Assistant Docker Labels Container customization can now be made by Docker labels instead of, or in addition to, env vars API Throttling Docker API now throttled per registry if receives 429 Too Many Requests Uses retry_after header value, if missing or unreadable defaults to configurable default_api_backoff Local Builds General overhaul of some issues and improvements for local git repo image builds Version now synthesized in place of image version git:<short sha> for current versiongit:<short sha>+<commits behind> for latest version Auto update policy restricted to when there’s an update to build For local git repos, install available check made now at discovery time Install update in HA only appears if there’s a pull available Internal Many more test cases added, focusing on Docker and MQTT integration Self-bounce now recognized and attempts to set exit code to 1, though container may still override that 1.5.2 Internal Build backend changed to uv_build GitHub Actions workflows updated, including to new uv actions 1.5.1 MQTT_VERSION environment variable added, defaults to 3.11U2M_AUTOGEN_CONFIG environment variable added to control auto-generation of config files and directoriesU2M_LOG_LEVEL environment variable added to set log level without config fileTitle generation for Docker images reverts to same whether HA device set or not Test added to ensure component always functions without a config file, if no env var present 1.5.0 Target specific service on docker compose commands, where available from com.docker.compose.service label Log level in config is now an enum, and forced to be upper case Removed unnecessary latest_version fields from config message, which also saves a redundant MQTT subscription Publication of command_topic for each discovery can now be forced with force_command_topic option More common packages: docker:cli Common packages can now match on the image ref rather than base name, for example docker:cli Reduced log noise in INFO and increased logging detail for DEBUG Common Packages now allow entries without all the values, initially rtl_433 which lacks a logo 1.4.2 Replace origin in config MQTT message with device for better HomeAssistant compatibility An area can be defined in the Home Assistant section of config and this will then be used as suggested_area for device Icon and release note info added for Owntone, Nextcloud, n8n, and Homarr More testcases 1.4.1 More logging for Docker discovery on why Home Assistant doesn’t show an update button More test cases MqttClient is now MqttPublisher to avoid confusion with actual MQTT clientTask cleanup now only interrupts explicit list of tasks - healthcheck and discovery tasks 1.4.0 MQTT protocol can now be set, to one of 3.1,3.11 or 5 Debug messages now provided for on_subscribe and on_unsubscribe callbacks Troubleshooting, installation, configuration docs updated, images optimized 1.3.7 Improved initial setup when run without config or env vars for MQTT Minor test deps update and pyproject docs 1.3.6 Changed exit code on graceful shutdown to 143 App now exits if the MQTT username / password is not authorized Improved handling of env vars, default config now assumes MQTT_HOST etc unless overridden Will now run without a config if correct MQTT_HOST,MQTT_USER,MQTT_PASS,MQTT_PORT env vars set or match the defaults (127.0.0.1:1883) Deps update