f52b4ae2b4
Made-with: Cursor
Homepage config
Config for 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:
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.