Homepage

Homepage

Self-hosted dashboard for the homelab. Runs via Docker on the NAS (nas) server, proxied through Traefik over HTTPS.

URL: https://homepage.nas.iot-proxmox.net

Stack

Item	Value
Image	ghcr.io/gethomepage/homepage:v1.11.0
Container	Homepage
Network	proxy (external, Traefik)
Config mount	./config → /app/config
Env file	.env

Directory Structure

Homepage/
├── docker-compose.yaml
├── .env                  # All service URLs and API keys
└── config/
    ├── bookmarks.yaml    # Quick-link bookmarks
    └── widgets.yaml      # Top-bar widgets (resources, clock, search)

Deployment

docker compose up -d

The /var/run/docker.sock volume mount is commented out in docker-compose.yaml. Docker integration via the socket is disabled; Portainer is used instead.

Settings (settings.yaml)

• Theme: Dark / Slate
• Background: Custom image with blur sm, brightness 50
• Layout: useEqualHeights: true; all groups use style: row

Group	Columns
Hypervisor	3
Containers	4
Network	3
Authentication	2
Storage	3
Media	3
Arr	3
Home Automation	2
Other	2

Top-bar Widgets (widgets.yaml)

• Resources — CPU, memory, and root disk usage
• Datetime — Clock (short time style, XL text)
• Search — Google, opens in new tab

Service Groups (services.yaml)

Hypervisor

| Service | Widget | Variable | |—|—|—| | PVE | proxmox (node: genkai) | HOMEPAGE_VAR_PROXMOX_URL | | PBS | proxmoxbackupserver | HOMEPAGE_VAR_PROXMOX_BS_URL | | Homelab | link only | HOMEPAGE_VAR_HOMELAB_URL |

Containers

| Service | Widget | Variable | |—|—|—| | Portainer | portainer (env: 3) | HOMEPAGE_VAR_Portainer_URL, HOMEPAGE_VAR_Portainer_Key | | Filebrowser | link only | HOMEPAGE_VAR_Filebrowser_URL |

Network

| Service | Widget | Variable | |—|—|—| | Gatus | gatus | HOMEPAGE_VAR_Gatus_URL | | Gateway (Unifi) | unifi | HOMEPAGE_VAR_UNIFI_URL | | Traefik | traefik | HOMEPAGE_VAR_Traefik_URL, HOMEPAGE_VAR_Traefik_Username/Password |

Authentication

| Service | Widget | Variable | |—|—|—| | Authentik | authentik | HOMEPAGE_VAR_Authentik_URL, HOMEPAGE_VAR_Authentik_Key |

Storage

| Service | Widget | Variable | |—|—|—| | TrueNAS | truenas | HOMEPAGE_VAR_TRUENAS_URL, HOMEPAGE_VAR_TRUENAS_KEY | | Code-Server | link only | HOMEPAGE_VAR_CODE_SERVER_URL |

Media

| Service | Widget | Variable | |—|—|—| | Handbrake | link only | HOMEPAGE_VAR_Handbrake_URL | | Jellyfin | jellyfin | HOMEPAGE_VAR_Jellyfin_URL, HOMEPAGE_VAR_Jellyfin_Key | | Immich | immich (v2) | HOMEPAGE_VAR_Immich_URL, HOMEPAGE_VAR_Immich_Key |

Arr

| Service | Widget | Variable | |—|—|—| | QBittorrent | qbittorrent | HOMEPAGE_VAR_QBIT_URL | | Radarr | radarr | HOMEPAGE_VAR_Radarr_URL, HOMEPAGE_VAR_Radarr_KEY | | Sonarr | sonarr | HOMEPAGE_VAR_Sonarr_URL, HOMEPAGE_VAR_Sonarr_KEY |

Home Automation

| Service | Widget | Variable | |—|—|—| | Home Assistant | link only (widget commented out) | HOMEPAGE_VAR_HOME_ASSISTANT_URL | | Frigate | frigate (recentEvents enabled) | HOMEPAGE_VAR_Frigate_URL |

Other

| Service | Widget | Variable | |—|—|—| | GitHub | link only | hardcoded | | Gitea | gitea | HOMEPAGE_VAR_GITEA_URL, HOMEPAGE_VAR_GITEA_KEY |

Bookmarks (bookmarks.yaml)

Group	Entry
Developer	GitHub
Social	Reddit
Entertainment	YouTube