# 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.