Homarr v2.14.0: Header widgets and shareable themes
Put widgets and notifications in your header, share complete themes through Workshop, and connect a Homey Pro or Yuvomi instance. Boards finish loading while slow integrations fetch their data.
Important
If you self-host Workshop, back up its pb_data volume before upgrading Workshop. Wait until clients support themes before converting legacy CSS listings, and take a fresh backup before conversion. Reload any listing edits opened before the upgrade to pick up the new revision. Workshop upgrade instructions
If you run Homarr from source, use Node.js 24.22.3 or later. The Docker image already bundles the security update. #7604
Highlights
Widgets and notifications in the header
Add personal Widget and Notifications controls to the header. Click a control to open its popover, or open it in board edit mode to configure the widget and popover size. Notifications now include Beszel alerts, dismissible Home Assistant notifications, and Uptime Kuma incidents and monitor status.
Complete themes in Workshop
Browse and publish complete themes through Workshop, or copy and paste a theme as JSON. Choose whether to apply an imported preset or custom CSS, then save to apply your changes. On desktop, the CSS editor sits beside the live board preview.
Guided Custom Widget setup
Connect an API and test a request in the guided editor, then use the response to build and preview your widget. Use Advanced mode for manual authoring, define typed widget options, and optionally share the result through Workshop.
Containers that adapt to media activity
A container can watch a Media Server widget and collapse or hide when nobody is watching. When a stream starts, it reappears and can shrink to fit its content. Media Server can also show playback details when only a few streams are active.
New integrations and widgets
New
- Header controls: Open personal widget and notification popovers and receive alerts from Beszel, Home Assistant, and Uptime Kuma. by @ajnart in #7608
- Workshop themes: Browse, publish, and import complete themes and edit CSS alongside the live preview. by @ajnart in #7645
- Custom Widgets: Set up APIs with a guided editor, use typed options, and share widgets through Workshop. by @ajnart in #7358
- Smart Containers: Collapse or hide idle media containers, fit active content, and see more playback details. by @Bergasha in #7394
- Homey Pro: Connect Homey Pro to existing smart home widgets. Entity State and Execute Automation now offer searchable pickers for both Homey and Home Assistant. by @spkesDE in #7646
- Yuvomi: Track open tasks, high-priority tasks, and items to buy with the Statistics widget. by @ulsklyc in #7493
- Download categories: Set or clear categories for qBittorrent and Deluge, or labels for Transmission, from the Download Client widget. by @heathlarsen in #7370
Improved
- Widget refresh intervals: Set how often Health Monitoring and System resources refresh under Advanced options. by @spkesDE in #7599
- More polling widgets: Set refresh intervals for System disks, Download Client, Media Server, Media Transcoding, DNS Hole, Firewall, and Docker containers. by @spkesDE in #7631
- Board loading: Home and named boards can finish loading while requests for live widget data run separately. by @ajnart in #7651
- RSS publishers: Show each article’s feed title in the widget and expanded view, with an option to hide it. by @Pieeeeeeeeeeeee in #7576
- RSS appearance: Set poster width and height and hide the blurred article background in the board view. by @Pieeeeeeeeeeeee in #7622
Fixed
- App editing: Edit app settings again from the dashboard and keep drafts when switching between widget and app settings. by @ajnart in #7643
- Item dialogs: Repository and app creation dialogs open above the item editor, with usable dropdowns and keyboard focus. by @ajnart in #7609
- Assistant board edits: Keep enabled tools across chat continuations and edit individual widget options while preserving layouts and integration bindings. by @ajnart in #7611
- RSS dates and descriptions: Use publication dates to order Atom and YouTube entries and show YouTube video descriptions when provided. by @TbhVishal in #7545
- Board saves and undo: Keep edits and undo actions on their original board and enforce timeouts on supported integration requests. by @ajnart in #7302
All changes
Improved
- Demo board: Explore widgets on dedicated Home, Media, and Systems tabs with layouts for phones. by @ajnart in #7577
- System resource charts: Lightweight sparklines reduce rendering work on boards with many charts. by @spkesDE in #7623
- Media Releases: Long release lists render in batches as you scroll. by @spkesDE in #7624
Fixed
- Custom Widget diagnostics: See clearer preview errors and confirm exactly which options or other definition elements will be removed before saving an update. by @ajnart in #7413
- Homey devices: Keep device status and controls available when a flow request fails, and show motion for covers that report it without a position. by @ajnart in #7650
- Plex release links: Open Plex Web without duplicate path segments and preserve reverse-proxy prefixes. by @ajnart in #7613
- Release groups: Remember manually expanded groups after a reload. by @ajnart in #7570
- Chart alignment: Align system resource charts when their groups have no scrollbar. by @spkesDE in #7600
- Spanish Uptime Kuma status: Label a down monitor “Caído.” by @bfs2021 in #7625
- Bundled NGINX: Update NGINX in the Docker image to 1.30.7 for upstream security fixes. by @AnalyticETH in #7639
- Bundled Redis: Update the Redis server and CLI in the Docker image to 8.8.4 for upstream security fixes. by @ajnart in #7606
- Next.js security updates: Update the application runtime to Next.js 16.4.6. by @ajnart in #7640
- Dependency security updates: Patch the XML parser, redirect handler, and query-string parser. by @ajnart in #7605
- More dependency security updates: Patch Glob, Minimatch, and Seroval. by @ajnart in #7641
Thanks
Thanks to first-time contributors @TbhVishal in #7545, @ulsklyc in #7493, @bfs2021 in #7625, @Pieeeeeeeeeeeee in #7576, @spkesDE in #7623, and @AnalyticETH in #7639.
Full Changelog: v2.13.1...v2.14.0


