Know which containers have updates, and try Homedex without installing
Image update checks
Add an Image updates source and Homedex checks, once a day, whether the tag each container runs now points at a newer build than the one it is running. Services with a newer build get an update badge on the Services page, and an Update available filter shows just those.
- Read-only and anonymous. It sends manifest
HEADrequests to the registries your images come from (Docker Hub, ghcr.io, lscr.io, quay.io, and others through their token challenge). It never pulls layers, and Docker Hub does not count these requests against pull limits. - Honest statuses. Up to date, update available, pinned (the image is referenced by digest), or unknown with the reason, for example a private registry or a locally built image. It never guesses.
- One change-feed entry per new build, not one per scan, so your existing change notifications can alert you when something you run has been republished.
Live demo
A read-only demo with fabricated lab data now runs in your browser: https://harshshah0203.github.io/homedex/. Nothing is installed and nothing you change is saved.
Install from one file
Trying Homedex no longer needs a checkout or a build:
mkdir homedex
cd homedex
curl -fsSLO https://raw.githubusercontent.com/HarshShah0203/homedex/main/docker-compose.yml
docker compose up -dIt pulls the published multi-arch image and keeps every hardening setting (socket proxy with POST disabled, read-only filesystem, no capabilities, loopback bind). HOMEDEX_VERSION pins a release, and building from source still works with docker-compose.build.yml.
Want to build a connector?
Unraid, TrueNAS, Pi-hole, AdGuard Home and Kubernetes are open as good first issues, each with verified API notes. A connector is three methods and never writes the database; the README's "Write a connector" section shows the shape.
Upgrading
Migration 0009 runs on first start and only adds a table. Existing installs that used the old build-from-source compose file can switch to the new one, or keep building with the override. See the upgrade and backup notes.
Container images are published to ghcr.io/harshshah0203/homedex.