Skip to main content

Updated documentation with better organization & design

ยท One min read

We'd like to let you know that we've updated our documentation and reorganized the pages. This means, that some links may no longer be valid - we apologise if this causes any inconvenience for you.

A few highlights include:

  • Updated navigation bar for much easier navigation
  • Improvements to the landing page
  • Completely revamped about us page.
  • Bug fixes for image zoom
  • Added documentation for management pages and new CLI tool

Please let us know is something is not working as expected.

Authentication in Homarr - 0.14 is here!

ยท 3 min read

One of the most requested features ever has arrived. We worked for months to prepare Homarr for this update and we're happy that we can finally provide you a viable solution today.

Highlights at a glanceโ€‹

  • ๐Ÿš€ Completly overhauled authentication system with user management
  • โœจ Improved UI for boards (renamed dashboards to boards).
  • ๐Ÿ’ป Server side preferences -> Dark mode and language are not synced accross all your devices
  • ๐Ÿ”— Invitation links to easily onboard new users
  • ๐Ÿ‘ฅ Overhauled board management with easy control if anonymous users can view your board
  • ๐Ÿง  AI assistant on the documentation to answer your questions:
  • ๐Ÿ“ Overhauled notepad widget with a complex graphical editor that enables easy editing right from your browser.
  • ๐ŸŒ Live Translation on Crowdin that enable you to directly translate using images to see what exactly you're translating

Breaking changesโ€‹

  • Removed PASSWORD environment variable
  • Removed DISABLE_EDIT_MODE environment variable
  • Removed EDIT_MODE_PASSWORD environment variable
  • Added mounting point /data for your database
  • Require at least one administrator account on your instance. An onboarding process will automatically set this up.
  • We've added analytics to the documentation and Homarr itself. We use Umami Analytics which collects anonymous data exclusively and protects your personal data rights. You can disable this using the environment variable DISABLE_ANALYTICS. More information here

Changes in detailโ€‹

Management pagesโ€‹

image One of the most requested features ever has been authentication. We've completely removed the PASSWORD, DISABLE_EDIT_MODE and EDIT_MODE_PASSWORD and replaced it by a secure authentication system that enables you to manage multiple users easily. We will allow for more detailed permission and user management soon. LDAP and OIDC integrations are currently also in progress and will arrive in a future version.

New dashboard layoutโ€‹


We've updated the dashboard user interface slightly to an updated design.

Server side preferences pageโ€‹


Previously, preferences were stored per dashboard and applied to all users. In this release, we moved this page to a separate link and store this on the server. This means that regardless what device your on - your preferences will stay the same when you're logged in.

Invitations for new usersโ€‹


Tired of creating user accounts by yourself? With the new "invites" feature you can invite new users by simply sending them a link. This link is valid only once and must have an expiration date - more info on that in our documentation.

Additionally, you can deny users, that are not logged into an account, to access your board with a simple toggle:


New "boards" pageโ€‹

Previously, dashboards were managed in an ugly and hard to control popup. We've moved this now to the new management pages as well and it's now much easier to control:


Read-only for non-administrators and guestsโ€‹

Yes, managing access to your dashboard is now much easier! Guests and non-administrators cannot edit your dashboard in any way (edit is hidden):


This is not an definite solution and will be significantly improved in an upcoming update.

We are aware that this update has many breaking changes and may confuse some users. For that reason, we updated our documentation and will enhance it further within the next few weeks. We've also added this small button at the bottom of the page were you can ask your questions to an AI assistant:


We present: Homarr 0.12 - The fastest homarr version ever!

ยท 3 min read

Multiple widgets of the same typeโ€‹

It's finally here! You can decorate your dashboard now with as many widgets as you want. This applies to all widgets, but in the case of the IFrame widget, it enables you to:

  • Integrate as many websites as you want
  • Integrate monitoring tools like Grafana, Splunk or Elasticsearch
  • Integrate your services (for example Sonarr, Radarr and Overseerr) directly into Homarr

Edit mode passwordโ€‹

We've added a setting to disable editing completely. This will allow you to restrict edit access without password-protection. use the EDIT_MODE_PASSWORD ENV variable to set a password for edit mode. turn on DISABLE_EDIT_MODE=TRUE to disable edit mode on startup.

๐Ÿ˜Ž Blazingly fastโ€‹

We've implemented a new caching system, that will cache all data in your browser, meaning that Homarr will load within milliseconds, as if it was powered by rust and blazingly fast !!!

Media request widgets (Overseerr & Jellyseerr)โ€‹

We've implemented a new widget, that displays a history of all requests. You can't approve from the widget yet, but we plan to add this in the future.


Multiple RSS feedsโ€‹

You can now consume multiple RSS feeds at the same time:


Tab refresh / close confirmationโ€‹

Since some have lost their changes, by refreshing the page in the edit mode. We've added a popup that will ask you to confirm you want to reload the page :


Environment variable for default themeโ€‹

You can now set the default color scheme using environment variables:

DEFAULT_COLOR_SCHEME = [dark, light]

Global error catching for widgetsโ€‹

Previously, widgets were able to crash your entire dashboard and just a blank page would be displayed. Now, users will still be able to use their dashboard and an information message will be displayed instead.

Migration to Mantine V6โ€‹

We've migrated Mantine to version 6. This will bring some upstream changes for responsiveness and usability.

Fix width and height in the calendarโ€‹

In 0.11.5 and previous versions, the calendar scaled poorly if the widget was resized. Now, the calendar will fill out the entire available space and scale nicely with your dashboard.

Performance improvementsโ€‹

We now use several methods to improve performance and reduce network requests. Homarr will load now within milliseconds and cache data in your browser.

Docker Socket via TCPโ€‹

Previously, it was not possible to mount sockets via TCP (eg. tcp://traefik-docker-socket-proxy:2375). Now, you can use the following environment variables to configure this:


Full Changelog:

We present: Homarr 0.11 - the most complex Homarr version yet!

ยท 2 min read

We are incredibly proud to serve you Homarr 0.11! It contains many breaking changes and huge improvements to your favourite dashboard app:

  • Integration of Gridstack for much more complex dashboard configuration and drag and drop
  • Added icon picker with smart search and automatic icons
  • Complete overhaul of the module system
  • Added an edit mode for making changes easier
  • Form validation for better user experience
  • Better security with new built-in credentials system
  • Huge design and usability improvements to older components to Homarr
  • Better handeling of exceptions and unexpected issues

Complete implementation of highly customizable drag and drop library "Gridstack"โ€‹

In 0.11, we have replaced our quite limited drag and drop system with Gridstack. Gridstack enables you to create much more complex and advanced dashboards while keeping everything organized.

We've also introduced more advanced categories this time:

We'll continute to improve this system according to your feedback.

Modules have been overhauled and renamed to widgetsโ€‹

Widgets are now much snappier and have been completly recoded. This fixes some of the bugs a few users have previously experienced and improves overall customization.

Fancy icon picker for speeding up your creation processโ€‹

We've also added a new fancy icon picker, you can use to get access to any icons much faster. We will add more icon sources in the future, as we made this icon picker very modular, and we plan to make local icons accessible via this picker very soon.

Design and documentation improvements to homarr.devโ€‹ has been overhauled with better design, updated documentation, more images and better explanations. We've also added a few community made resources, such as the icon cache script and Traefik tutorial.

Download Homarr now!โ€‹

Homarr is completly free, even for commercial usage!

Help us make Homarr multilingual

ยท One min read

We've been working hard to offer Homarr in many languages. The next update of Homarr will be using i18next to translate almost any part of your Dashboard.

We need your helpโ€‹

Yes, we need YOU! We want to make Homarr accessible to as many people as possible. Thus, we need to translate all content into many different languages. We need your help for that! You can help us now to translate Homarr into as many languages as possible.

About global translations / translations per userโ€‹

We are aware that many people would like to configure translations globally or configure language per user. Currently, translations are stored in the Cookies, which will expire after some time (currently, it's set to 30 days). We will implement more granular language settings in future versions of Homarr, since it requires major changes to Homarr. Stay tuned! ๐Ÿ˜Ž

Migration of Documentation

ยท 2 min read

We are happy to announce that the documentation of Homarr has been migrated to Docusaurus - An opensource documentation tool. The documentation has been re-written partly and includes now many animations, guides and additional crucial information.

We are still figuring things out and highly depend on your feedback.

Why we migratedโ€‹

The default Github Wiki feature is decent - but very confusing to read. Our possibilites for searching the documentation in the Wiki are highly limited. Additionally, Users are unable to contribute to the documentation if they have not sufficient permissions.

We could not review any chanegs made to the documentation. This is why we migrated to Docusaurus.

How you can contributeโ€‹

The documentation will soon be merged into the master branch of Homarr. You'll find a doc/ directory in the root of Homarr. We'll obviously not include this in our Docker images. In the future, everyone may modify the documentation by creating a pull request. After we've reviewed your changes, we'll merge your PR and this documentation will automatically update.


The documentation on GitHub Wiki will soon disappear. It will be replaced with this Docusaurus-powered website. You'll find much more information here with higher detail and searchability.