Files

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.