30 lines
1.6 KiB
Markdown
30 lines
1.6 KiB
Markdown
# 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`
|