Initial commit: Glance and Homepage homelab configs

Made-with: Cursor
2026-04-29 21:17:53 -04:00
commit f52b4ae2b4
8 changed files with 720 additions and 0 deletions
@@ -0,0 +1,68 @@
+# Homepage config
+
+Config for [gethomepage.dev](https://gethomepage.dev/) — an alternative/companion
+to the `glance.yml` in the parent folder. Same services, different dashboard style.
+
+All self-hosted services live under `*.klhoud.com`.
+
+## Files
+
+| File                | Purpose                                                              |
+| ------------------- | -------------------------------------------------------------------- |
+| `settings.yaml`     | Title, theme, layout order, providers                                |
+| `services.yaml`     | Service cards (Homelab / Work / Projects) + widgets where supported  |
+| `bookmarks.yaml`    | Quick-link groups                                                    |
+| `widgets.yaml`      | Info widgets (resources, search, weather, datetime, greeting)        |
+| `docker.yaml`       | Docker host definitions (commented out — fill in if/when you wire it)|
+| `kubernetes.yaml`   | Disabled placeholder                                                 |
+
+## Environment variables
+
+`services.yaml` references these via `{{HOMEPAGE_VAR_*}}`. Set them on the
+Homepage container (Coolify → Environment Variables). Any that are omitted just
+make that widget show an error — the service card itself still renders.
+
+```
+HOMEPAGE_VAR_NEXTCLOUD_USER
+HOMEPAGE_VAR_NEXTCLOUD_PASS     # Nextcloud app password, NOT your login password
+HOMEPAGE_VAR_ADGUARD_USER
+HOMEPAGE_VAR_ADGUARD_PASS
+HOMEPAGE_VAR_PROXMOX_USER       # e.g. api@pam!homepage
+HOMEPAGE_VAR_PROXMOX_TOKEN
+```
+
+Also required so Homepage allows iframed/proxied requests from your domain:
+
+```
+HOMEPAGE_ALLOWED_HOSTS=homepage.klhoud.com
+```
+
+## Docker / Coolify deploy
+
+Mount this folder at `/app/config`:
+
+```yaml
+services:
+  homepage:
+    image: ghcr.io/gethomepage/homepage:latest
+    container_name: homepage
+    ports:
+      - 3000:3000
+    volumes:
+      - ./homepage:/app/config
+      # - /var/run/docker.sock:/var/run/docker.sock:ro  # optional
+    environment:
+      HOMEPAGE_ALLOWED_HOSTS: homepage.klhoud.com
+      HOMEPAGE_VAR_NEXTCLOUD_USER: ${HOMEPAGE_VAR_NEXTCLOUD_USER}
+      HOMEPAGE_VAR_NEXTCLOUD_PASS: ${HOMEPAGE_VAR_NEXTCLOUD_PASS}
+      HOMEPAGE_VAR_ADGUARD_USER:   ${HOMEPAGE_VAR_ADGUARD_USER}
+      HOMEPAGE_VAR_ADGUARD_PASS:   ${HOMEPAGE_VAR_ADGUARD_PASS}
+      HOMEPAGE_VAR_PROXMOX_USER:   ${HOMEPAGE_VAR_PROXMOX_USER}
+      HOMEPAGE_VAR_PROXMOX_TOKEN:  ${HOMEPAGE_VAR_PROXMOX_TOKEN}
+    restart: unless-stopped
+```
+
+## Heads-up
+
+Your `glance.yml` (parent folder, lines 127 & 213) contains a committed GitHub
+PAT. Rotate it and move it to an env var before pushing anywhere public.