Safer LAN installs, and Homedex in app stores
Set the admin password before first start
Until now, a fresh Homedex waited for whoever opened it first to choose the admin password. That is fine on 127.0.0.1, but homelab app stores publish the UI on your LAN.
Set HOMEDEX_ADMIN_PASSWORD (or HOMEDEX_ADMIN_PASSWORD_FILE for a Docker or Compose secret) and Homedex stores it as the admin password on first start, exactly as the setup wizard would. The setup page is then closed to everyone else.
- It never replaces an existing admin; later starts ignore it and say so in the log.
- A password under 12 characters stops the container with a clear error.
- The value is never logged, and it is removed from the environment after it is read, so tools Homedex starts never inherit it.
Built-in health check
The image now declares a health check (homedex healthcheck), so Docker, Compose and app stores can tell when Homedex is ready. The image is distroless, with no shell or curl, so the check lives in the binary itself.
Coming to app stores
Listings are being submitted for the TrueNAS apps catalog, the CasaOS and ZimaOS store, the Cosmos marketplace, Unraid Community Applications and the Portainer community templates. This release adds what they need: the admin password setting, the health check, an icon and a Portainer stack template.
Fixes
- A registry connection test that passed early could leave a cancelled connection attempt behind, and a scan started right after could misread that registry as unreachable. Fixed.
- Live demo links such as
/homedex/hostsnow answer 200, so they preview properly when shared.
Upgrading
No migrations. Pull the new image (docker compose pull then docker compose up -d). The one-file install already follows the 0.2 line.
Container images are published to ghcr.io/harshshah0203/homedex.