In this guide, we will show you how to migrate from Homarr 0.15.10+ to 1.0.0. If you are still on a version before 0.15.10, please update to 0.15.10 where we introduced the migration export page.

In the release v1.0.0-beta.10 we introduced a newly required env variable SECRET_ENCRYPTION_KEY. This key is used to encrypt sensitive data in the database. Before this release, the key was generated automatically and stored in the anonymous volume /secrets. Because of the deletion of anonymous volumes between updates, by some installation methods, we decided to move this key to an environment variable.

We are proud to announce the open beta of Homarr 1.0. This is a major milestone for us and we are excited to share it with you. The open beta allows us to polish the last rough edges and gather feedback from you. We are looking forward to your feedback and hope you enjoy the new features. Let us know throgh discord or a github issues if you encounter any issues.

We proudly present to you - Homarr 1.0. We have started work on this new version back in 2023 and have worked tirelessly for months on this brand-new dashboard.

This isn't our usual update. 1.0 doesn't use the same code from previous versions, but has been written from the ground up. Therefore, this version contains an unusual amount of breaking changes. This will be a one time occurrence and version > 1.0 will have less breaking changes. This time more important than every; read the breaking changes list and create a backup before updating. Some third party installation methods may take multiple days or weeks to update to the new version.

See this guide on how to import your previous Homarr dashboard

Changes at a glance​

• Asynchronous integrations system: In versions prior to 1.0, we fetched data upon each request synchronously. This means that the user had to wait for the requests to finish so any data would appear. A page reload will trigger another request - and worse, this will happen for every user accessing your dashboard. In 1.0, we have implemented a new system that gets rid of this system and scales linearly. It will fetch data in background, even if you are not on the page.
• Permissions system: You can now use detailed permissions to allow or prohibit users from certain actions. For easier management, you can organize users into groups and manage them all at the same time.
• Integration testing: Starting from 1.0, we will require you to test the integration before you can use it. This guarantees that you've configured your integration correctly and helps you find errors faster.
• Re-imagined widgets: All widgets have been rewritten & improved. They offer much better performance, reliability and scalability compared to < 1.0.
• Improved performance: We have upgraded the underlying framework of Homarr and take advantage of an in-memory message bus and websockets to deliver data near realtime to you.

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.

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: https://homarr.dev/
• 📝 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

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.

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

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.

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.