Homepage
Homepage: a first setup, important settings, verification, and recovery considerations.
Working directory: ~/homelab/apps/dashboards. Follow the common setup workflow first. This is a setup note based on the linked documentation, not a copy of my live configuration or a runtime verification of this full stack.
Start here
Homepage is a list of service links with optional widgets. Start with the official Docker setup and manually entered links. Do not mount the Docker socket merely to display a bookmark. Begin with one harmless link to the practice web page.
Settings and data
Persist /app/config. Keep services.yaml, settings.yaml, and any widget credentials separate from public examples. Set HOMEPAGE_ALLOWED_HOSTS to the hostnames you actually use according to the documentation. It is host validation, not visitor authentication.
Check it
Open the dashboard through your chosen private access path and click the practice link. A link is opened by your browser, so its hostname must work from the browser's machine, not just from inside the container. Confirm configuration survives recreation.
When something fails
For a rejected host, compare the browser URL and allowed-host setting. For a broken widget, check network reachability and the widget's scoped credential. A read-only Docker socket mount still exposes a powerful API; prefer no socket for this initial setup. Back up configuration without publishing its private links.