69 lines
2.6 KiB
Markdown
69 lines
2.6 KiB
Markdown
# 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.
|