homarr-dashboard/config/board-layouts.md

Homarr Board Layouts

Board 1: 🏠 Main Dashboard (Public)

Purpose: Quick overview and commonly used links Visibility: Public (no login required)

Layout Structure

┌─────────────────────────────────────────────────────────────────┐
│  [CLOCK & WEATHER]    [SEARCH BAR]    [SYSTEM STATUS OVERVIEW] │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  📰 NEWS & UPDATES                                              │
│  ┌──────────────┐ ┌──────────────┐ ┌──────────────┐            │
│  │  Homelab RSS │ │  Cyber RSS   │ │  Tech RSS    │            │
│  │  [Widget]    │ │  [Widget]    │ │  [Widget]    │            │
│  └──────────────┘ └──────────────┘ └──────────────┘            │
│                                                                 │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  🔗 QUICK LINKS                                                 │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐  │
│  │  Gmail  │ │ GitHub  │ │ Reddit  │ │ YouTube │ │ Discord │  │
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘  │
│                                                                 │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  🏠 INFRASTRUCTURE QUICK ACCESS                                 │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐  │
│  │Proxmox  │ │Portainer│ │  Plex   │ │Nextcloud│ │  Vault  │  │
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘  │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Widgets

1. Clock - Large, centered, with date
2. Weather - Current location weather
3. RSS Feeds - 3 separate widgets (Homelab, Cyber, Tech)
4. System Health Monitor - Quick status from Dash.
5. Bookmarks - External services

Apps

• Gmail, GitHub, Reddit, YouTube, Discord
• Proxmox, Portainer, Plex, Nextcloud, Vaultwarden
• Tailscale, Cloudflare

---

Board 2: 🔧 Infrastructure (Private)

Purpose: Complete infrastructure management Visibility: Private (requires login)

Layout Structure

┌─────────────────────────────────────────────────────────────────┐
│  INFRASTRUCTURE MANAGEMENT                          [USER MENU] │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  📊 SYSTEM MONITORING (Full Dash. iFrame)                      │
│  ┌───────────────────────────────────────────────────────────┐ │
│  │                                                           │ │
│  │              [Dash. WIDGET - Full Width]                  │ │
│  │              CPU | RAM | STORAGE | NETWORK               │ │
│  │                                                           │ │
│  └───────────────────────────────────────────────────────────┘ │
│                                                                 │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  🖧 NETWORK & VIRTUALIZATION                                     │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐  │
│  │Proxmox  │ │ UniFi   │ │OPNsense │ │Pi-hole  │ │AdGuard  │  │
│  │         │ │         │ │         │ │         │ │         │  │
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘  │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐  │
│  │Traefik  │ │   NPM   │ │WireGuard│ │Tailscale│ │  VPN    │  │
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘  │
│                                                                 │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  💾 STORAGE & BACKUP                                             │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐              │
│  │TrueNAS  │ │Portainer│ │  MinIO  │ │Syncthing│              │
│  │  SCALE  │ │         │ │         │ │         │              │
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘              │
│                                                                 │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  📈 MONITORING STACK                                             │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐  │
│  │ Grafana │ │Prometheus│ │Uptime   │ │ Netdata │ │  Beszel  │  │
│  │         │ │         │ │  Kuma   │ │         │ │         │  │
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘  │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Widgets

1. Dash. iFrame - Full system monitoring
2. DNS Hole - Pi-hole/AdGuard stats
3. System Health Monitor - Proxmox integration

Apps

All infrastructure-related apps from the apps.json configuration.

---

Board 3: 🎬 Media Center (Private)

Purpose: Media server management Visibility: Private (requires login)

Layout Structure

┌─────────────────────────────────────────────────────────────────┐
│  MEDIA CENTER                                       [USER MENU] │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  📺 MEDIA SERVERS                                                │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐                           │
│  │  Plex   │ │Jellyfin │ │  Emby   │                           │
│  │[Widget] │ │[Widget] │ │         │                           │
│  └─────────┘ └─────────┘ └─────────┘                           │
│                                                                 │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  🎬 ARR STACK                                                    │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐  │
│  │ Sonarr  │ │ Radarr  │ │ Lidarr  │ │Readarr  │ │ Bazarr  │  │
│  │   TV    │ │ Movies  │ │  Music  │ │  Books  │ │Subtitles│  │
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘  │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐                           │
│  │Prowlarr │ │Overseerr│ │Jellyseer│                           │
│  │ Indexers│ │ Requests│ │ Requests│                           │
│  └─────────┘ └─────────┘ └─────────┘                           │
│                                                                 │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ⬇️ DOWNLOAD CLIENTS                                             │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐  │
│  │ qBittor-│ │Transsmis│ │ Deluge  │ │ SABnzbd │ │ NZBGet  │  │
│  │   rent  │ │  sion   │ │         │ │         │ │         │  │
│  │[Widget] │ │[Widget] │ │         │ │         │ │         │  │
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘  │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Widgets

1. Media Server - Active sessions from Plex/Jellyfin
2. Torrent - Download progress
3. Usenet - Download progress
4. Media Requests - Overseerr/Jellyseerr integration

---

Board 4: 📊 System Overview (Private)

Purpose: Comprehensive system monitoring Visibility: Private (requires login)

Layout Structure

┌─────────────────────────────────────────────────────────────────┐
│  SYSTEM OVERVIEW                                    [USER MENU] │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  [FULL SCREEN Dash. IFRAME]                                     │
│  ┌───────────────────────────────────────────────────────────┐ │
│  │                                                           │ │
│  │     CPU USAGE        RAM USAGE       STORAGE USAGE       │ │
│  │    ┌─────┐           ┌─────┐          ┌─────┐            │ │
│  │    │ 45% │           │ 62% │          │ 78% │            │ │
│  │    └─────┘           └─────┘          └─────┘            │ │
│  │                                                           │ │
│  │  ┌─────────────────────────────────────────────────────┐ │ │
│  │  │              NETWORK SPEED GRAPH                     │ │ │
│  │  │         [Real-time upload/download]                  │ │ │
│  │  └─────────────────────────────────────────────────────┘ │ │
│  │                                                           │ │
│  │  ┌─────────────────────────────────────────────────────┐ │ │
│  │  │              DETAILED SYSTEM INFO                    │ │ │
│  │  │  OS: Ubuntu 22.04    Uptime: 45 days                │ │ │
│  │  │  CPU: Intel Xeon     Cores: 24                     │ │ │
│  │  │  RAM: 96GB DDR4      Storage: 12TB                 │ │ │
│  │  └─────────────────────────────────────────────────────┘ │ │
│  │                                                           │ │
│  └───────────────────────────────────────────────────────────┘ │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

---

Board 5: 📰 News Hub (Public)

Purpose: RSS feed aggregation Visibility: Public (no login required)

Layout Structure

┌─────────────────────────────────────────────────────────────────┐
│  NEWS HUB                                           [SEARCH]   │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  🏠 HOMELAB NEWS                                                 │
│  ┌───────────────────────────────────────────────────────────┐ │
│  │                                                           │ │
│  │  [RSS Widget - Selfh.st, Noted, Self-Hosted Podcast]      │ │
│  │                                                           │ │
│  │  • New Docker container release... [2h ago]              │ │
│  │  • How to setup Authelia with... [5h ago]                │ │
│  │  • Top 10 self-hosted apps for... [1d ago]               │ │
│  │                                                           │ │
│  └───────────────────────────────────────────────────────────┘ │
│                                                                 │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  🔒 CYBERSECURITY NEWS                                           │
│  ┌───────────────────────────────────────────────────────────┐ │
│  │                                                           │ │
│  │  [RSS Widget - Bleeping Computer, Hacker News, Krebs]     │ │
│  │                                                           │ │
│  │  • Critical vulnerability found in... [30m ago]          │ │
│  │  • New ransomware campaign targets... [3h ago]           │ │
│  │  • Security patch released for... [6h ago]               │ │
│  │                                                           │ │
│  └───────────────────────────────────────────────────────────┘ │
│                                                                 │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  💻 TECHNOLOGY NEWS                                              │
│  ┌───────────────────────────────────────────────────────────┐ │
│  │                                                           │ │
│  │  [RSS Widget - Hacker News, TechCrunch, Ars Technica]     │ │
│  │                                                           │ │
│  │  • New AI model released by... [1h ago]                  │ │
│  │  • Tech company announces... [4h ago]                    │ │
│  │  • Open source project reaches... [12h ago]              │ │
│  │                                                           │ │
│  └───────────────────────────────────────────────────────────┘ │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘