Homarr Release Notes

What's Changed

• chore(lang): updated translations from crowdin by @homarr-crowdin[bot] in #7204
• docs: clarify request limits, Kuma API checks, and JSX icons by @ajnart in #7205
• docs(helm): update chart installation page by @homarr-charts-docs-sync[bot] in #7203
• chore: update bug report template by @homarr-releases[bot] in #7173
• chore: update contributors by @homarr-update-contributors[bot] in #7208
• chore(lang): updated translations from crowdin by @homarr-crowdin[bot] in #7212
• feat(calendar): add saved calendar view switching by @ajnart in #7125
• fix: restore DNS behavior from 2.0.0 by @ajnart in #7207
• fix(auth): support anonymous LDAP service binds by @ajnart in #7175
• fix(downloads): select qBittorrent jobs before display limit by @ajnart in #7107
• fix(media-server): let page scrolling pass through the streams widget by @Bergasha in #7227
• docs(env): document ENABLE_DOCKER and ENABLE_KUBERNETES by @pcbeingused333 in #7221
• fix(ui): preserve profile theme selection by @ajnart in #7218
• fix(docker): retain configured columns and compact table widths by @ajnart in #7101
• docs(env): clarify Docker demo exception by @ajnart in #7230
• ci: pin the third-party actions, branch-scope the image caches and drop the checkout token where nothing pushes by @Totara-thib in #7072
• feat(integrations): add sportarr by @Sportarr in #6518
• chore: update integrations list readme by @homarr-update-contributors[bot] in #7234
• chore(lang): updated translations from crowdin by @homarr-crowdin[bot] in #7222
• fix(board): preserve collapsed container order by @ajnart in #7200
• fix(board): clip collapsed container overflow by @ajnart in #7232
• fix(apps): remove app URL validation by @ajnart in #7238
• fix(synology): submit login parameters in form body by @ajnart in #7229
• fix(releases): avoid long provider loading delays by @ajnart in #7193
• fix(beszel): align usage color thresholds with upstream by @ajnart in #7244
• feat(auth): log client IP on failed logins by @TameTheGame in #7242
• feat(media-server): redesign the session details popup by @Bergasha in #7228
• fix(integrations): make Emby RunTimeTicks optional for media releases by @pcbeingused333 in #7220
• fix(widgets): keep docker rows visible on wide cards by @ZikriBen in #7168
• feat(app-form): suggest the icon of the app website in the image picker by @junkerderprovinz in #6562
• chore(lang): updated translations from crowdin by @homarr-crowdin[bot] in #7246
• fix(security): harden session payload, integration grants, integration test, releases and RSS by @ajnart in #7243
• feat(uptime-kuma): rework integration and widget around status page heartbeats by @ajnart in #7213
• feat(integrations): add Thingport integration and widgets by @TautvydasDerzinskas in #7223
• feat(releases): hide Docker suggestions per item by @ajnart in #7239
• chore: update integrations list readme by @homarr-update-contributors[bot] in #7248
• fix(wazuh): consolidate views and indexer certificate handling by @Nerdy-Technician in #7211
• chore(release): automatic release v2.7.0 by @github-actions[bot] in #7250

New Contributors

• @pcbeingused333 made their first contribution in #7221
• @Totara-thib made their first contribution in #7072
• @Sportarr made their first contribution in #6518
• @TameTheGame made their first contribution in #7242
• @TautvydasDerzinskas made their first contribution in #7223

Full Changelog: v2.6.0...v2.7.0

What's Changed

• chore: update bug report template by @homarr-releases[bot] in #7169
• feat(releases): show running versions from linked integrations by @hasier in #7149
• ci: don't fail integration list workflow when readme is unchanged by @ajnart in #7171
• chore(lang): updated translations from crowdin by @homarr-crowdin[bot] in #7179
• chore(lang): updated translations from crowdin by @homarr-crowdin[bot] in #7190
• revert: restore previous ping behavior by @ajnart in #7189
• docs(helm): update chart installation page by @homarr-charts-docs-sync[bot] in #7184
• fix(prowlarr): use POST to test all indexers by @bmarden in #7183
• fix(custom-widgets): support all Tabler icons with local SVG sprites by @ajnart in #7198
• fix(board): keep widget UI density consistent by @ajnart in #7192
• fix(board): avoid extra scrolling on short boards by @ajnart in #7199
• perf(dashboard): prioritize cached startup and parallel refreshes by @ajnart in #7176
• fix: group recent Jellyfin episode batches by series by @ajnart in #7103
• chore(release): automatic release v2.6.0 by @github-actions[bot] in #7201

New Contributors

• @hasier made their first contribution in #7149
• @bmarden made their first contribution in #7183

Full Changelog: v2.5.2...v2.6.0

What's Changed

• fix: fit Beszel Y-axis labels by @ajnart in #7137
• chore(lang): updated translations from crowdin by @homarr-crowdin[bot] in #7144
• chore: update bug report template by @homarr-releases[bot] in #7119
• docs(helm): update chart installation page by @homarr-charts-docs-sync[bot] in #7124
• fix(release): generate changelogs with GitHub release notes by @ajnart in #7121
• fix: unify collapsible container headers and spacing by @ajnart in #7153
• perf: apply 57 performance and accessibility improvements across dashboards and services by @ajnart in #7154
• fix(ci): speed up checks and fix Workshop publication by @ajnart in #7138
• fix: match native Beszel chart colors and hover points by @ajnart in #7159
• docs(brand): add Homarr share images and their generator by @ajnart in #7158
• fix: honor container border color by @ajnart in #7151
• feat: allow health widget tab order by @ajnart in #7152
• fix(auth): synchronize singleton OIDC group claims by @Riccardo-Vecchi in #7089
• fix: enable assistant by default and preserve onboarding state by @ajnart in #7135
• feat(releases): use compact localized release ages by @ajnart in #7155
• fix: reveal resize grips on item hover and focus by @ajnart in #7157
• perf(plex): index proxied release images by @Riccardo-Vecchi in #7100
• fix(ping): treat every HTTP response as reachable by @ajnart in #7133
• chore(audit): security, runtime, widget and maintenance bundle by @ajnart in #7146
• chore(lang): updated translations from crowdin by @homarr-crowdin[bot] in #7162
• chore(release): prepare v2.5.0 by @ajnart in #7167

Full Changelog: v2.4.1...v2.5.0

2.4.0 (2026-10-09)

What's Changed

• chore(lang): updated translations from crowdin by @homarr-crowdin[bot] in #7091
• chore: update bug report template by @homarr-releases[bot] in #7084
• fix(release): restore glibc SQLite bindings in Debian archives by @ajnart in #7098
• fix(aria2): remove active and queued download jobs correctly by @Riccardo-Vecchi in #7088
• fix(stocks): prevent compact quote overlap by @ajnart in #7079
• fix: collapse mobile management navigation after link selection by @ajnart in #7102
• perf(downloads): bound Transmission and Deluge item mapping by @Riccardo-Vecchi in #7095
• Revert "fix(onboarding): return to welcome before administrator creation" by @ajnart in #7111
• chore(deps): update alpine docker tag to v3.24.2 by @homarr-renovate[bot] in #7114
• feat: add Docker name filter matching controls by @ajnart in #7105
• fix(health-monitoring): remember cluster accordion choices by @ajnart in #7104
• feat: group bookmarks and streamline app creation by @ajnart in #7080
• feat: add board snapshot playground by @ajnart in #7112
• perf(request-handler): reduce cache expiry work by @darbyjack in #7108
• perf(media): revalidate uploaded images with ETags by @darbyjack in #7116
• perf(ical): index recurrence exceptions by UID by @Riccardo-Vecchi in #7090
• chore(release): automatic release v2.4.0 by @github-actions[bot] in #7118

New Contributors

• @Riccardo-Vecchi made their first contribution in #7088

Full Changelog: v2.3.0...v2.4.0

2.3.0 (2026-10-07)

What's Changed

• fix(lang): restore English UK labels corrupted by Crowdin by @ajnart in #7050
• fix: avoid Pi-hole discovery authentication failures by @ajnart in #7032
• chore(lang): updated translations from crowdin by @homarr-crowdin[bot] in #7049
• docs(helm): update chart installation page by @homarr-charts-docs-sync[bot] in #7046
• fix: allow unlimited sidebar content while editing by @ajnart in #7061
• chore: update bug report template by @homarr-releases[bot] in #7044
• fix: return dashboard settings header to current board by @ajnart in #7059
• fix(dns-hole-summary): restore colors and fit compact cards by @ajnart in #7045
• fix(db): explain unsupported MySQL upgrade options by @ajnart in #7063
• fix: keep dashboard CSS out of board settings by @ajnart in #7066
• fix: collapse Beszel controls on touch screens by @ajnart in #7065
• fix(widgets): allow narrow Docker and downloads tables to scroll by @ajnart in #7067
• fix(boards): reduce phone outer gutters by @ajnart in #7070
• chore(deps): update dependency shell-quote@<1.8.5 to v1.11.0 [security] by @homarr-renovate[bot] in #7071
• feat(api): expose existing dashboard controls by @rfdrew in #6546
• fix: avoid stretching Beszel charts while rows overflow by @ajnart in #7074
• chore: use Bun package management and Turbo remote caching by @ajnart in #6978
• fix(board): separate nested container headers by @ajnart in #7060
• fix(widgets): restore readable summary text and icons by @ajnart in #7068
• fix(docs): simplify integration secrets styling by @ajnart in #7076
• feat(rss-feed): add configurable description max length by @ZikriBen in #7051
• chore(release): automatic release v2.3.0 by @github-actions[bot] in #7077
• chore(release): automatic release v2.3.0 by @github-actions[bot] in #7082

New Contributors

• @rfdrew made their first contribution in #6546
• @ZikriBen made their first contribution in #7051

Full Changelog: v2.2.0...v2.3.0

2.2.0 (2026-10-05)

What's Changed

• docs(helm): update chart installation page by @homarr-charts-docs-sync[bot] in #7039
• feat: add create-only root certificate API by @ajnart in #7033
• fix(demo): stop seeded widget background polling by @ajnart in #6980
• feat(sabnzbd): add archived history options to the Downloads widget by @Sobe1ac in #6515
• chore(lang): updated translations from crowdin by @homarr-crowdin[bot] in #6986
• feat: support Unraid storage pools by @ajnart in #7038
• feat(widgets): add GPU metrics to Beszel system stats by @SmilingJoe in #6645
• chore: update bug report template by @homarr-releases[bot] in #7028
• fix: report GitHub icon indexing failures clearly by @ajnart in #7008
• chore(release): automatic release v2.2.0 by @github-actions[bot] in #7043

New Contributors

• @Sobe1ac made their first contribution in #6515
• @SmilingJoe made their first contribution in #6645

Full Changelog: v2.1.2...v2.2.0

2.1.0 (2026-10-03)

What's Changed

• chore: update contributors by @homarr-update-contributors[bot] in #6911
• chore(deps): update dependency brace-expansion@>=4.0.0 <5.0.9 to v5.0.12 [security] by @homarr-renovate[bot] in #6958
• fix(deps): update dependency mysql2 to v3.23.1 [security] by @homarr-renovate[bot] in #6965
• chore(deps): update dependency fast-uri@>=3.0.0 <3.1.6 to v3.1.8 [security] by @homarr-renovate[bot] in #6959
• chore(deps): update dependency axios@>=1.0.0 <1.18.1 to v1.20.0 [security] by @homarr-renovate[bot] in #6962
• chore(deps): update dependency ip-address@<10.3.1 to v10.7.1 [security] by @homarr-renovate[bot] in #6964
• chore(deps): update dependency @grpc/grpc-js@<1.12.7 to v1.13.6 [security] by @homarr-renovate[bot] in #6961
• fix: restore app icon sizing on scaled boards by @ajnart in #6972
• docs(helm): update chart installation page by @homarr-charts-docs-sync[bot] in #6970
• chore: update bug report template by @homarr-releases[bot] in #6957
• chore(deps): update dependency brace-expansion@>=2.0.0 <2.1.4 to v2.1.7 [security] by @homarr-renovate[bot] in #6967
• chore(deps): update dependency next to v16.3.6 [security] by @homarr-renovate[bot] in #6960
• chore(deps): update dependency brace-expansion@>=1.0.0 <1.1.18 to v1.1.21 [security] by @homarr-renovate[bot] in #6966
• docs(readme): fix installation links and sync integrations by @ajnart in #6996
• fix: use native DNS resolution by default for Docker services by @ajnart in #6997
• chore: trim supporting files from Docker DNS fix by @ajnart in #7011
• feat(api): test connections using stored integration credentials by @ajnart in #7014
• fix: classify Plex music releases correctly by @ajnart in #6977
• fix(board): restore layouts after column changes by @ajnart in #6979
• fix(integrations): accept persisted IDs when updating by @ajnart in #6985
• docs(migration): explain backups and board scaling by @ajnart in #6991
• fix(board): persist setup checklist dismissal by @ajnart in #6992
• fix: include Jellyfin releases across mixed libraries by @ajnart in #6998
• fix(board): make container headers fully clickable by @ajnart in #7006
• fix(onboarding): return to welcome before administrator creation by @ajnart in #7012
• fix(unifi): count active remote VPN sessions by @ajnart in #7013
• fix(docker): resolve Homepage Dashboard Icons keys by @ajnart in #7004
• docs: require agent docs and tests only when user-critical by @ajnart in #7021
• fix(integrations): authenticate Frigate stats and HTTP requests by @ajnart in #7019
• chore(release): automatic release v2.1.0 by @github-actions[bot] in #7026

Full Changelog: v2.0.0...v2.1.0

2.0.0 (2026-10-02)

We just shipped Homarr 2.0.0, the biggest homarr update ever

The big two: Custom Widgets and Workshop

Custom Widgets v2 lets you build almost any widgets. Build it with JSX, define the options it has and add it to your instance. Write them yourself, or describe what you want and generate it. Custom widgets can re-use existing integrations without the need to enter credentials or support any API endpoint.

Workshop pairs nicely with it: You can publish, vote on, explore and install widgets & custom CSS other users have shared. We ask that you test and validate your slop before submitting it, or other users will downvote you into oblivion

Board editing has been rebuilt

New drag and drop system based on dnd-kit, doesn't suck anymore Containers replace Groups and dynamic sections. We added sidebars back, they stay put while the board scrolls.

Why "the front door to your homelab"?

Homarr already connects to your services through integrations. In v2, Integration Requests let other Homarr features reuse those connections without exposing the underlying service credentials.

For example, a Custom Widget can request data from Sonarr through Homarr. Homarr checks that the request is allowed, makes the request using the credentials stored on your instance, and returns the result. The same system is available over HTTP and, optionally, MCP. This means you can give an MCP-compatible client access to selected Homarr capabilities without giving that client the API keys for every service in your homelab nor direct network access to those services.

TLDR, if an app's api can do it, you are now able to do it through Homarr, even when there is no button for it, with a custom widget, an api call or the mcp.

What else changed?

Onboarding is completely reworked, you should be able to get started in less time than it took you to read this post

Configure every item in the header, and hide what you don't need.

Press shift on widgets for advanced view, revealing more info and controls

Instance branding: name, logo, favicon, colors and global CSS can be setup instance-wide.

Statistics widget combines metrics from different services in one grid, compatible with every integration

31 new integrations, including Autobrr, FileFlows, Frigate, Gatus, Karakeep, Linkwarden, Prometheus, RomM and more

Docker and Podman support with multiple endpoints, assisted setup and docker labels

Performance: startup work runs in parallel, heavy screens load on demand, duplicate requests share cache And a** very** long list of bug fixes

Thank you! To everyone who tested rough builds, found bugs, translated, answered questions or contributed code: this would not exist without you. We are planning free limited-edition swag for our favorite workshop contributions as well as a few randomly picked community members on the way, stay tuned.

We hope you are as excited about this release as we are to share it with you!

Checkout the v2 recap video on the blog : https://homarr.dev/blog/2026/09/03/homarr-2.0/

Try the demo and browse Workshop:

Demo: https://demo.homarr.dev/

Workshop: https://homarr.dev/workshop

Full Changelog: v1.77.2...v2.0.0