Update Homepage dashboard and deployment scripts

- Homepage: Reorganize services by stack instead of by category
- Homepage: Add comprehensive Available to Install sections for all stacks
- Homepage: Update config templates with {{HOMEPAGE_VAR_DOMAIN}} placeholder
- Homepage: Change layout from row to column style
- Scripts: Add sudo requirement to deploy-homelab.sh
- Scripts: Replace NVIDIA driver installation with official installer method
- Scripts: Add build prerequisites and nouveau blacklisting
- Docs: Add AI Automation Guidelines section to docker-guidelines.md
- Docs: Document Homepage auto-update requirements and workflow
- Config: Add bookmarks.yaml template for Homepage
- Config: Add alternatives.yml compose file (Portainer, Authentik)
- Config: Update .env.example and authelia configuration

config-templates/homepage/bookmarks.yaml

@@ -0,0 +1,29 @@
+---
+# Homepage Bookmarks
+
+- Documentation:
+    - GitHub Repository:
+        - icon: github.png
+          href: https://github.com/kelinfoxy/AI-Homelab
+          description: AI-Homelab Repository
+          
+    - Homepage Docs:
+        - icon: homepage.png
+          href: https://gethomepage.dev
+          description: Homepage Documentation
+
+- Useful Links:
+    - DuckDNS:
+        - icon: duckdns.png
+          href: https://www.duckdns.org
+          description: Dynamic DNS Service
+          
+    - Let's Encrypt:
+        - icon: si-letsencrypt
+          href: https://letsencrypt.org
+          description: SSL Certificate Provider
+          
+    - Docker Hub:
+        - icon: docker.png
+          href: https://hub.docker.com
+          description: Container Images

config-templates/homepage/services.yaml

@@ -1,373 +1,245 @@
-# Homepage Configuration - Services
-# Copy to /opt/stacks/homepage/config/services.yaml
-# This file is AI-configurable - Homepage will auto-discover services via Docker labels
-
 ---
-# Infrastructure Services
-- Infrastructure:
-    - Dockge:
-        icon: dockge.png
-        href: https://dockge.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Docker Compose Stack Manager (PRIMARY)
-        container: dockge
-        widget:
-          type: dockge
-          url: http://dockge:5001
+# Currently Installed Services - Grouped by Stack
 
+- Core Stack (core.yml):
     - Traefik:
         icon: traefik.png
         href: https://traefik.{{HOMEPAGE_VAR_DOMAIN}}
         description: Reverse Proxy & SSL
-        container: traefik
-        widget:
-          type: traefik
-          url: http://traefik:8080
-
+        
     - Authelia:
         icon: authelia.png
         href: https://auth.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Single Sign-On
-        container: authelia
-        widget:
-          type: authelia
-          url: http://authelia:9091
-
-    - Portainer:
-        icon: portainer.png
-        href: https://portainer.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Docker Management (Secondary)
-        container: portainer
-        widget:
-          type: portainer
-          url: http://portainer:9000
-          env: 1
-          key: {{HOMEPAGE_VAR_PORTAINER_KEY}}
-
-    - Pi-hole:
-        icon: pi-hole.png
-        href: https://pihole.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Network-wide Ad Blocking
-        container: pihole
-        widget:
-          type: pihole
-          url: http://pihole
-          key: {{HOMEPAGE_VAR_PIHOLE_KEY}}
+        description: Authentication Portal
 
+- Infrastructure Stack (infrastructure.yml):
+    - Dockge:
+        icon: dockge.png
+        href: https://dockge.{{HOMEPAGE_VAR_DOMAIN}}
+        description: Docker Compose Manager
+        
     - Dozzle:
         icon: dozzle.png
         href: https://dozzle.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Real-time Docker Logs
-        container: dozzle
-
+        description: Real-time Log Viewer
+        
     - Glances:
         icon: glances.png
         href: https://glances.{{HOMEPAGE_VAR_DOMAIN}}
         description: System Monitoring
-        container: glances
-        widget:
-          type: glances
-          url: http://glances:61208
-          metric: cpu
+        
+    - Pi-hole:
+        icon: pi-hole.png
+        href: https://pihole.{{HOMEPAGE_VAR_DOMAIN}}
+        description: Network-wide Ad Blocking
 
-# Dashboards
-- Dashboards:
+- Dashboards Stack (dashboards.yml):
+    - Homepage:
+        icon: homepage.png
+        href: https://home.{{HOMEPAGE_VAR_DOMAIN}}
+        description: This Dashboard
+        
     - Homarr:
         icon: homarr.png
         href: https://homarr.{{HOMEPAGE_VAR_DOMAIN}}
         description: Alternative Dashboard
-        container: homarr
 
-    - Uptime Kuma:
-        icon: uptime-kuma.png
-        href: https://status.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Uptime Monitoring
-        container: uptime-kuma
-        widget:
-          type: uptimekuma
-          url: http://uptime-kuma:3001
-          slug: {{HOMEPAGE_VAR_UPTIMEKUMA_SLUG}}
+- Alternatives Stack (alternatives.yml):
+    - Portainer:
+        icon: portainer.png
+        href: https://portainer.{{HOMEPAGE_VAR_DOMAIN}}
+        description: Container Management UI
+        
+    - Authentik:
+        icon: authentik.png
+        href: https://authentik.{{HOMEPAGE_VAR_DOMAIN}}
+        description: Alternative Auth Provider
 
-# Media - Streaming
-- Media Streaming:
+# Available to Install - Grouped by Stack
+
+- Media Stack (media.yml):
     - Plex:
         icon: plex.png
         href: https://plex.{{HOMEPAGE_VAR_DOMAIN}}
         description: Media Server
-        container: plex
-        widget:
-          type: plex
-          url: http://plex:32400
-          key: {{HOMEPAGE_VAR_PLEX_KEY}}
-
+        
     - Jellyfin:
         icon: jellyfin.png
         href: https://jellyfin.{{HOMEPAGE_VAR_DOMAIN}}
         description: Open Source Media Server
-        container: jellyfin
-        widget:
-          type: jellyfin
-          url: http://jellyfin:8096
-          key: {{HOMEPAGE_VAR_JELLYFIN_KEY}}
-
-    - Jellyseerr:
-        icon: jellyseerr.png
-        href: https://jellyseerr.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Media Requests
-        container: jellyseerr
-        widget:
-          type: jellyseerr
-          url: http://jellyseerr:5055
-          key: {{HOMEPAGE_VAR_JELLYSEERR_KEY}}
-
-# Media - Management
-- Media Management:
+        
     - Sonarr:
         icon: sonarr.png
         href: https://sonarr.{{HOMEPAGE_VAR_DOMAIN}}
-        description: TV Show Management
-        container: sonarr
-        widget:
-          type: sonarr
-          url: http://sonarr:8989
-          key: {{HOMEPAGE_VAR_SONARR_KEY}}
-
+        description: TV Shows Automation
+        
     - Radarr:
         icon: radarr.png
         href: https://radarr.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Movie Management
-        container: radarr
-        widget:
-          type: radarr
-          url: http://radarr:7878
-          key: {{HOMEPAGE_VAR_RADARR_KEY}}
-
-    - Lidarr:
-        icon: lidarr.png
-        href: https://lidarr.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Music Management
-        container: lidarr
-        widget:
-          type: lidarr
-          url: http://lidarr:8686
-          key: {{HOMEPAGE_VAR_LIDARR_KEY}}
-
-    - Readarr:
-        icon: readarr.png
-        href: https://readarr.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Book Management
-        container: readarr
-        widget:
-          type: readarr
-          url: http://readarr:8787
-          key: {{HOMEPAGE_VAR_READARR_KEY}}
-
+        description: Movies Automation
+        
     - Prowlarr:
         icon: prowlarr.png
         href: https://prowlarr.{{HOMEPAGE_VAR_DOMAIN}}
         description: Indexer Manager
-        container: prowlarr
-        widget:
-          type: prowlarr
-          url: http://prowlarr:9696
-          key: {{HOMEPAGE_VAR_PROWLARR_KEY}}
-
-# Downloads
-- Downloads:
+        
     - qBittorrent:
         icon: qbittorrent.png
         href: https://qbit.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Torrent Client (via VPN)
-        container: qbittorrent
-        widget:
-          type: qbittorrent
-          url: http://gluetun:8080
-          username: {{HOMEPAGE_VAR_QBITTORRENT_USER}}
-          password: {{HOMEPAGE_VAR_QBITTORRENT_PASS}}
+        description: Torrent Client
 
-    - Gluetun:
-        icon: gluetun.png
-        href: http://gluetun:8000
-        description: VPN Client (Surfshark)
-        container: gluetun
-
-# Books & Comics
-- Books & Comics:
+- Media Extended Stack (media-extended.yml):
+    - Readarr:
+        icon: readarr.png
+        href: https://readarr.{{HOMEPAGE_VAR_DOMAIN}}
+        description: Books Automation
+        
+    - Lidarr:
+        icon: lidarr.png
+        href: https://lidarr.{{HOMEPAGE_VAR_DOMAIN}}
+        description: Music Automation
+        
+    - Mylar3:
+        icon: mylar.png
+        href: https://mylar.{{HOMEPAGE_VAR_DOMAIN}}
+        description: Comics Manager
+        
     - Calibre-Web:
         icon: calibre-web.png
         href: https://calibre.{{HOMEPAGE_VAR_DOMAIN}}
         description: Ebook Library
-        container: calibre-web
-
-    - Lazy Librarian:
-        icon: lazylibrarian.png
-        href: https://lazylibrarian.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Book Manager
-        container: lazylibrarian
-
-    - Mylar3:
-        icon: mylar3.png
-        href: https://mylar.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Comic Book Manager
-        container: mylar3
-
-# Transcoding
-- Transcoding:
+        
+    - Jellyseerr:
+        icon: jellyseerr.png
+        href: https://jellyseerr.{{HOMEPAGE_VAR_DOMAIN}}
+        description: Media Request Manager
+        
     - Tdarr:
         icon: tdarr.png
         href: https://tdarr.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Distributed Transcoding
-        container: tdarr-server
-        widget:
-          type: tdarr
-          url: http://tdarr-server:8265
+        description: Media Transcoding
 
-    - Unmanic:
-        icon: unmanic.png
-        href: https://unmanic.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Library Optimizer
-        container: unmanic
-
-# Home Automation
-- Home Automation:
+- Home Automation Stack (homeassistant.yml):
     - Home Assistant:
         icon: home-assistant.png
         href: https://ha.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Home Automation Hub
-        # Note: Uses host network, configure manually
-        widget:
-          type: homeassistant
-          url: http://{{HOMEPAGE_VAR_SERVER_IP}}:8123
-          key: {{HOMEPAGE_VAR_HA_KEY}}
-
+        description: Home Automation Platform
+        
     - ESPHome:
         icon: esphome.png
         href: https://esphome.{{HOMEPAGE_VAR_DOMAIN}}
         description: ESP Device Manager
-        container: esphome
-
+        
     - Node-RED:
         icon: node-red.png
         href: https://nodered.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Flow Automation
-        container: nodered
-
-    - TasmoAdmin:
-        icon: tasmota.png
-        href: https://tasmoadmin.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Tasmota Device Manager
-        container: tasmoadmin
-
+        description: Flow-based Automation
+        
     - Zigbee2MQTT:
         icon: zigbee2mqtt.png
-        href: https://zigbee2mqtt.{{HOMEPAGE_VAR_DOMAIN}}
+        href: https://zigbee.{{HOMEPAGE_VAR_DOMAIN}}
         description: Zigbee Bridge
-        container: zigbee2mqtt
+        
+    - Mosquitto:
+        icon: mosquitto.png
+        href: https://mqtt.{{HOMEPAGE_VAR_DOMAIN}}
+        description: MQTT Broker
 
-    - MotionEye:
-        icon: motioneye.png
-        href: https://motioneye.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Video Surveillance
-        container: motioneye
-
-# Productivity
-- Productivity:
+- Productivity Stack (productivity.yml):
     - Nextcloud:
         icon: nextcloud.png
         href: https://nextcloud.{{HOMEPAGE_VAR_DOMAIN}}
-        description: File Sync & Share
-        container: nextcloud
-        widget:
-          type: nextcloud
-          url: http://nextcloud
-          username: {{HOMEPAGE_VAR_NEXTCLOUD_USER}}
-          password: {{HOMEPAGE_VAR_NEXTCLOUD_PASS}}
-
+        description: Cloud Storage & Collaboration
+        
+    - Gitea:
+        icon: gitea.png
+        href: https://gitea.{{HOMEPAGE_VAR_DOMAIN}}
+        description: Git Repository
+        
     - Mealie:
         icon: mealie.png
         href: https://mealie.{{HOMEPAGE_VAR_DOMAIN}}
         description: Recipe Manager
-        container: mealie
-
-    - Gitea:
-        icon: gitea.png
-        href: https://git.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Git Service
-        container: gitea
-
-    - Code Server:
-        icon: vscode.png
-        href: https://code.{{HOMEPAGE_VAR_DOMAIN}}
-        description: VS Code in Browser
-        container: code-server
-
-# Documentation
-- Documentation:
+        
     - BookStack:
         icon: bookstack.png
-        href: https://docs.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Documentation Platform
-        container: bookstack
-        widget:
-          type: bookstack
-          url: http://bookstack
-          key: {{HOMEPAGE_VAR_BOOKSTACK_KEY}}
-
+        href: https://bookstack.{{HOMEPAGE_VAR_DOMAIN}}
+        description: Wiki Platform
+        
     - DokuWiki:
         icon: dokuwiki.png
-        href: https://wiki.{{HOMEPAGE_VAR_DOMAIN}}
-        description: File-based Wiki
-        container: dokuwiki
-
-    - MediaWiki:
-        icon: mediawiki.png
-        href: https://mediawiki.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Wiki Platform
-        container: mediawiki
-
+        href: https://dokuwiki.{{HOMEPAGE_VAR_DOMAIN}}
+        description: Simple Wiki
+        
     - WordPress:
         icon: wordpress.png
-        href: https://blog.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Blog Platform
-        container: wordpress
+        href: https://wordpress.{{HOMEPAGE_VAR_DOMAIN}}
+        description: CMS Platform
 
-# Backups & Monitoring
-- Backups & Tools:
-    - Backrest:
-        icon: backrest.png
-        href: https://backrest.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Backup Manager (Restic)
-        container: backrest
-
-    - Duplicati:
-        icon: duplicati.png
-        href: https://duplicati.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Backup Software
-        container: duplicati
-
-# Monitoring Stack
-- Monitoring:
+- Monitoring Stack (monitoring.yml):
     - Grafana:
         icon: grafana.png
         href: https://grafana.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Metrics Visualization
-        container: grafana
-        widget:
-          type: grafana
-          url: http://grafana:3000
-          username: {{HOMEPAGE_VAR_GRAFANA_USER}}
-          password: {{HOMEPAGE_VAR_GRAFANA_PASS}}
-
+        description: Metrics Dashboard
+        
     - Prometheus:
         icon: prometheus.png
         href: https://prometheus.{{HOMEPAGE_VAR_DOMAIN}}
         description: Metrics Collection
-        container: prometheus
-        widget:
-          type: prometheus
-          url: http://prometheus:9090
-
+        
     - Uptime Kuma:
         icon: uptime-kuma.png
-        href: https://status.{{HOMEPAGE_VAR_DOMAIN}}
-        description: Status Page
-        container: uptime-kuma
+        href: https://uptime.{{HOMEPAGE_VAR_DOMAIN}}
+        description: Uptime Monitoring
+        
+    - Loki:
+        icon: loki.png
+        href: https://loki.{{HOMEPAGE_VAR_DOMAIN}}
+        description: Log Aggregation
+        
+    - cAdvisor:
+        icon: cadvisor.png
+        href: https://cadvisor.{{HOMEPAGE_VAR_DOMAIN}}
+        description: Container Metrics
+
+- Development Stack (development.yml):
+    - VS Code Server:
+        icon: vscode.png
+        href: https://code.{{HOMEPAGE_VAR_DOMAIN}}
+        description: Browser-based IDE
+        
+    - GitLab:
+        icon: gitlab.png
+        href: https://gitlab.{{HOMEPAGE_VAR_DOMAIN}}
+        description: DevOps Platform
+        
+    - Jupyter:
+        icon: jupyter.png
+        href: https://jupyter.{{HOMEPAGE_VAR_DOMAIN}}
+        description: Data Science Notebooks
+        
+    - pgAdmin:
+        icon: pgadmin.png
+        href: https://pgadmin.{{HOMEPAGE_VAR_DOMAIN}}
+        description: PostgreSQL Admin
+
+- Utilities Stack (utilities.yml):
+    - Backrest:
+        icon: mdi-backup-restore
+        href: https://backrest.{{HOMEPAGE_VAR_DOMAIN}}
+        description: Backup Solution
+        
+    - Duplicati:
+        icon: duplicati.png
+        href: https://duplicati.{{HOMEPAGE_VAR_DOMAIN}}
+        description: Backup Software
+        
+    - Vaultwarden:
+        icon: vaultwarden.png
+        href: https://vault.{{HOMEPAGE_VAR_DOMAIN}}
+        description: Password Manager
+        
+    - Formio:
+        icon: mdi-form-select
+        href: https://formio.{{HOMEPAGE_VAR_DOMAIN}}
+        description: Form Builder

config-templates/homepage/settings.yaml

@@ -1,63 +1,45 @@
-# Homepage Configuration - Settings
-# Copy to /opt/stacks/homepage/config/settings.yaml
-
 ---
-title: Homelab Dashboard
-background: https://images.unsplash.com/photo-1558591710-4b4a1ae0f04d
-backgroundOpacity: 0.2
+# Homepage Settings
+# For all configuration options: https://gethomepage.dev/configs/settings/
+
+title: AI Homelab Dashboard
+
 theme: dark
 color: slate
-headerStyle: boxed
-hideVersion: true
-hideErrors: false
-showStats: true
-target: _self  # Open links in same tab
 
-# Layout configuration
 layout:
-  Infrastructure:
-    style: row
-    columns: 4
-  Dashboards:
-    style: row
+  Core Stack (core.yml):
+    style: column
     columns: 2
-  Media Streaming:
-    style: row
-    columns: 3
-  Media Management:
-    style: row
+  Infrastructure Stack (infrastructure.yml):
+    style: column
     columns: 4
-  Downloads:
-    style: row
+  Dashboards Stack (dashboards.yml):
+    style: column
     columns: 2
-  Books & Comics:
-    style: row
-    columns: 3
-  Home Automation:
-    style: row
-    columns: 4
-  Productivity:
-    style: row
-    columns: 4
-  Documentation:
-    style: row
-    columns: 4
-  Backups & Tools:
-    style: row
+  Alternatives Stack (alternatives.yml):
+    style: column
     columns: 2
-  Monitoring:
-    style: row
+  Media Stack (media.yml):
+    style: column
     columns: 3
+  Media Extended Stack (media-extended.yml):
+    style: column
+    columns: 3
+  Home Automation Stack (homeassistant.yml):
+    style: column
+    columns: 3
+  Productivity Stack (productivity.yml):
+    style: column
+    columns: 3
+  Monitoring Stack (monitoring.yml):
+    style: column
+    columns: 3
+  Development Stack (development.yml):
+    style: column
+    columns: 4
+  Utilities Stack (utilities.yml):
+    style: column
+    columns: 4
 
-# Quick search
-quicklaunch:
-  searchDescriptions: true
-  hideInternetSearch: false
-  showSearchSuggestions: true
-
-# Providers for additional functionality
-providers:
-  longhorn:
-    url: http://longhorn:9500
-  openweathermap: {{HOMEPAGE_VAR_OPENWEATHER_KEY}}
-  weatherapi: {{HOMEPAGE_VAR_WEATHERAPI_KEY}}
+headerStyle: boxed

config-templates/homepage/widgets.yaml

@@ -1,14 +1,11 @@
-# Homepage Configuration - Widgets
-# Copy to /opt/stacks/homepage/config/widgets.yaml
-# Displays system resources and other information
-
 ---
-- logo:
-    icon: https://avatars.githubusercontent.com/u/...  # Your logo here
+# Homepage Widgets Configuration
+# Service widgets omitted per user request
 
-- search:
-    provider: google
-    target: _blank
+- resources:
+    cpu: true
+    memory: true
+    disk: /
 
 - datetime:
     text_size: xl
@@ -16,34 +13,3 @@
       dateStyle: long
       timeStyle: short
       hourCycle: h23
-
-- resources:
-    label: System
-    cpu: true
-    memory: true
-    disk: /
-    cputemp: true
-    uptime: true
-    units: metric
-
-- resources:
-    label: Storage
-    disk: /mnt/media
-    expanded: true
-
-- resources:
-    label: Downloads
-    disk: /mnt/downloads
-    expanded: true
-
-- openmeteo:
-    label: Weather
-    latitude: 40.7128
-    longitude: -74.0060
-    units: metric
-    cache: 5
-
-- unifi_console:
-    url: http://unifi:8443
-    username: {{HOMEPAGE_VAR_UNIFI_USER}}
-    password: {{HOMEPAGE_VAR_UNIFI_PASS}}