github homarr-labs/homarr v2.0.0

3 hours ago

2.0.0 (2026-10-02)

file-501fe61d3e0c510fc079deed55ed606e

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

Don't miss a new homarr release

NewReleases is sending notifications on new releases.