homepage/README.md

Homepage

Homepage provides a customizable homelab dashboard with service links, status widgets, and infrastructure integrations.

Deployment layout

• Compose: /srv/docker/homepage/docker-compose.yml
• Static configuration/source: /srv/docker/homepage/config for sanitized YAML, CSS, and JavaScript; /srv/docker/homepage/images for static dashboard images
• Non-secret environment: allowed host heimdall.lan and IPv6 proxy disabling are declared inline in Compose
• Secrets: /srv/docker/secrets/homepage/.env
• NVMe application state: /srv/appdata/homepage/logs and /srv/appdata/homepage/report
• Bulk HDD data: none
• Other mounts: /var/run/docker.sock read-only for Docker integration and /data/Data1 read-only for shared storage visibility

Secrets are never committed to this repository. The central secret environment is supplied to the Homepage service; sanitized YAML configuration references its widget and integration credentials through HOMEPAGE_VAR_* placeholders.

Dependencies and recovery

• Networks/dependencies: Homepage uses the external npm_proxy network at 192.168.96.11; Docker integration depends on the read-only Docker socket, storage reporting can use the read-only /data/Data1 mount, and configured widgets depend on their respective external services
• Back up: /srv/docker/homepage/config, /srv/docker/homepage/images, and the separately protected Homepage secret environment
• Re-creatable: the Homepage container image and /srv/appdata/homepage/logs and /srv/appdata/homepage/report