Homarr Versions Save

Customizable browser's home page to interact with your homeserver's Docker containers (e.g. Sonarr/Radarr)

v0.14.0

7 months ago

homarr-version-banner

The authentication update is here!

You can now create users and invite your friends on your homarr, instance! It is now considered safe to host on the web! Homarr's look has been almost completely overhauled, allowing you to have different users with personal preferences each by making use a new database.

[!NOTE] As always, if you like homarr please make sure to give it a star :star: or you could also make a donation Either would go a long way to support homarr ❤️

What's new?

  • :rocket: Authentication system with users and invites
  • :sparkles: Improved UI for boards (renamed dashboards to boards)
  • :computer: Server side preferences makes it so dark mode and language are now synced across all your devices
  • :link: Invitation links to easily onboard new users
  • :busts_in_silhouette: Allow guests to visit your dashboards or require users to have an account to interact with it
  • :brain: AI assistant powered by Kapa.ai on the documentation to answer your questions: https://homarr.dev/
  • :globe_with_meridians: Live Translation on Crowdin that enable you to directly translate using images to see what exactly you're translating, check it out at (the docs about live translations)[https://homarr.dev/docs/community/translations#using-live-translate]
  • :bug: A lot of bugs have been removed allowing a smoother experience. More info at the bottom of the page!

Please take a look at the new documentation website here : https://homarr.dev/

Let's take a look at what's new

🐳 New mountpoint

Since we now have a database in homarr in order to save your users, you need to add a new mountpoints, let's go over what's changed in your docker-compose.yml

[!WARNING]
If you do not add this mount point, you will lose your users database when updating to a new version

  homarr:
    container_name: homarr
    image: ghcr.io/ajnart/homarr:latest
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock # Optional, only if you want docker integration
      - ./homarr/configs:/app/data/configs
      - ./homarr/icons:/app/public/icons
+     - ./homarr/data:/data # Database mount point, can also be a volume 
    ports:
      - '7575:7575'

🗄️ Management pages

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. image

⭐ New dashboard layout

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

image

🔧 Server side preferences page

image

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

image

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 allow or deny access to guests (users without an account) to a specific board in it's customizations page with the following switch : image

🤩 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: image

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): image

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

[!NOTE]
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-powered assistant: image

This AI model was trained on the Homarr documentation and will try to answer as many of your questions as precise as possible. It is provided to us for free by the awesome team at kapa.ai ! 💥

image

What's Changed

New Contributors

Full Changelog: https://github.com/ajnart/homarr/compare/v0.13.4...v0.14.0

v0.13.4

9 months ago

image

Our previous had a few issues, when you used reverse proxies. This version rolled back a few of the changes and should fix all of the introduced problems.

What's Changed

Full Changelog: https://github.com/ajnart/homarr/compare/v0.13.3...v0.13.4

v0.13.3

9 months ago

homarr-version-banner

What's Changed

New Contributors

Full Changelog: https://github.com/ajnart/homarr/compare/v0.13.1...v0.13.3

v0.13.2

10 months ago

homarr-version-banner

We're thrilled to introduce the latest release of Homarr. This time it contains a new widget for notes, the possibility to show the time for different cities and a lot of bugfixes.

New notebook widget

The new notebook widget allows you to take notes directly on your Homarr dashboard. You can use all sort of stuff with headings, lists, generall styling and more!

image

Show time of city

You can now choose yourself which times should be shown on your dashboard. It's of course still possible to show the current time of your client.

image

Location of weather

You can now choose if the location of the weather should be shown. This is especially useful if you have multiple weather widgets on your dashboard.

image

More layouts for dns hole

You can now specify the layout of the dns hole as you want. We added support for vertical and horizontal layouts.

image

What's Changed

New Contributors

Full Changelog: https://github.com/ajnart/homarr/compare/v0.13.1...v0.13.2

v0.13.1

10 months ago

version-banner

We are excited to introduce the latest version of Homarr, packed with bug fixes, improvements to the Bookmark widget and several other design enhancements.

Fixed reversed controls in DNS Hole widget

In a previous version, a bug was accidentally introduced, that reverted the controls of the widget. This issue has been fixed and the controls will work as expected again.

Made improvements to the app tile

We made the app name hideable and created the possibility to put it on the side you want.

image image

Support for non standard URLs

Homarr used to only support https:// and http:// for the apps. This will stay this way for internal URLs. However, it can be useful to automatically open third party applications (Steam, E-Mail, specific applications, ...) when clicking on it. You can now use any protocol for the external URL in your apps:

255692315-0bdae8b4-0d1d-4315-bcdd-4b0938d7033d 255692430-326bb63e-9d41-416a-a6af-284bbc764a97

What's Changed

New Contributors

Full Changelog: https://github.com/ajnart/homarr/compare/v0.13.0...v0.13.1

v0.13.0

10 months ago

We are thrilled to announce the release of Homarr v0.13.0 ! This release brings exciting new features, enhanced accessibility, and improved performance to elevate your experience. We extend our gratitude to the contributors who made this release possible. Here are the key highlights of the closed pull requests since the previous release:

TRPC Migration:

🏗️ Migrated API endpoints to tRPC, thanks to @Meierschlumpf in #1032. This migration enhances the efficiency and scalability of our API, providing a smoother user experience.

Accessibility Improvements:

🚸 Improved accessibility across the application, thanks to the efforts of @manuel-rw in #980. We believe in inclusivity, and these enhancements make Homarr more accessible to users with different needs and abilities. 🚸 Removed automatic focus on search bar for mobile, thanks to @Meierschlumpf in #1058.

New features

✨ Added an option to hide/show week days on the calendar, thanks to @ajnart in #1109. Now you can customize the calendar view according to your preference. ✨ Introduced improved location selection for weather, thanks to @Meierschlumpf in #1044. It's now easier than ever to get accurate weather information for your desired locations.

Bug Fixes and Enhancements:

🐛 Fixed the Docker menu button issue, thanks to @ajnart in #1108. Now you can navigate seamlessly through the Docker menus. ⚡️ Improved the ping function for better performance, thanks to @ajnart in #1063. 🐛 Fixed pi-hole integration credentials, thanks to @Malong11-007 in #1152. ⚡️ Improved the design and behaviour of the calendar, thanks to @Tagaishi in #1154. You can now define the font-size of the calendar days to match better your dashboard configuration. 💄 Improved controls of dns-hole, thanks to @Tagaishi in #1159. The dashboard looks now even better than before.

Enjoy a faster and more responsive experience. Thank you to all the contributors who have dedicated their time and effort to make Homarr better with each release. Your contributions are invaluable, and we appreciate your support. We hope you enjoy the new features and enhancements in Homarr v0.13.0

Stay tuned for more exciting updates! 🦞

What we will work on from now-on

Authentication Upgrade and Migration to Sqlite

We are excited to share our upcoming plans for Homarr's security and data management. As we continue to enhance the platform, we have two significant updates in the pipeline:

Authentication Upgrade:

Currently, a portion of Homarr lacks the necessary security measures to be exposed to the internet. While there are existing authentication solutions available, they can be cumbersome to implement. To address this, we will be introducing a basic authentication solution using the new tRPC APIs. This upgrade will enhance the security of Homarr, allowing for a safer and more reliable user experience. Additionally, we will be phasing out the old legacy systems to streamline the authentication process.

Breaking Change: Migration from JSON to Sqlite:

Homarr currently relies on an unstructured JSON file for data management. This approach introduces complexities in terms of types, errors, exceptions, and relationships. To overcome these challenges, we have decided to migrate to a relational database management system (RDBMS). Starting from this version, Homarr will no longer support JSON as we transition to the more efficient and organized Sqlite format. This migration will significantly improve data management, ensuring a more robust and scalable platform.

We are committed to continuously enhancing the security and performance of Homarr. These upcoming updates demonstrate our dedication to providing a secure and seamless user experience. Stay tuned for these exciting releases, and thank you for your continued support as we evolve Homarr into an even more powerful tool.

Full Changelog

Full Changelog: https://github.com/ajnart/homarr/compare/v0.12.3...v0.13.0

v0.12.3

1 year ago

More Iframe settings

The iframe supports now more permissions:

image

Open bookmarks in new tab

You can now open bookmarks in a new tab:

image

Mixin RSS feed with HTML

Some feeds contain HTML. By default, we do not display this for security reasons. However, if you want to sanitize and display it anyway, you can now do this with the new option:

Widget menu for error boundary

To avoid crashes, we use error boundaries which will display a replacement if your widget doesn't work. However, in 0.12.2 and previous releases, the edit button was hidden by this and users weren't able to roll back. This has now been fixed.

Updated default config

The default config for new instances was slightly outdated and has been updated on our side. This should guarantee, that instances will just work out of the box with pings.

Fixed incompabillity with Jellyfin API

In 0.8, the Jellyfin migrated to ES modules. This causes Homarr to break partially. We mitigated the issue by transpiling the dependency correctly.

Fix API with Dash.

The API for Dash. was broken by a newer version of Dash. We have updated our implementation and it will display your storage again.

What's Changed

New Contributors

Full Changelog: https://github.com/ajnart/homarr/compare/v0.12.2...v0.12.3

v0.12.2

1 year ago

✨ Bookmarks, PiHole & AdGuard Home, IPv6 support, drop cache buttons

0.12.2 comes with a bunge of improvements for existing systems but also two big new widgets for your dashboard:

Introducing the Bookmark widget

Did you install Homarr, because you are tired of bookmarks? Using the new widget, you can save them now easily without having to add it as an application to your dashboard: image

Using the visual editor, changes can be made easily and fast: image

PiHole & AdGuard Home

If you're using PiHole or AdGuard Home to block privacy-invading telemetry data, advertisements or malicious domains, you might want to gain control and overview of your infrastructure. Using the new widget, you can do this now from your dashboard:

image

There's also a second widget, that can disable and enable your instances with one click:

image

Never mix up your Dash. instances

Users reported, that they had problems remembering what Dash. instance displayed data for their respective machines. In 0.12.2, we introduce a new option for you, where you can set the name of the widget:

image

image

IPv6 validation

Are you running IPv6? Previously, Homarr did not support those. Now, your apps should work like expected with IPv6.

Tired of cache?

In previous updates, we introduced a local cache to improve performance. This is a temporary measure, until we have migrated to tRPC, which enables us for much more performant caching, real time communication and more! Since many users had trouble with old data, that they had to wait for to be invalidated, you can now manually invalidate and clear the cache:

image

Changed to build system

We've also made a few significant changes behind the scenes. We now use Renovate to automatically update dependencies. This will ensure, that we always use the newest APIs available and don't miss out on security updates.

What's Changed

New Contributors

Full Changelog: https://github.com/ajnart/homarr/compare/v0.12.1...v0.12.2

v0.12.1

1 year ago

🚨 Critical bugfixes

Howdy hosters, this version is a smaller fix for issues that were introduced in 0.12. We're sorry for the trouble and inconvenience this might has caused.

Fixed the status pings

Due to a code change, only new installations of Homarr had working status codes. We have fixed this, by automatically converting the old values to the new format on the first page load. This change may take a few seconds to apply after updating your Homarr, and you need to save your config once to permanently fix it.

Fixed calendar sizing and indicators

0.12 introduced weird UI bugs, so indicators in the calender were stacked and not visible. Although this has been resolved in 0.12.1, we are still experiencing issues with the layout and will continue to make improvements in future versions.

Fixed the expected video stream type

We have fixed the video stream widget, so it can play now any supported file type.

Fixed RSS crash

We noticed, that the widget could crash if your configuration contained an older data format. This has been resolved similarly to the status pings and requires a save to be fixed permanently.

Fixed iframe width

Some users reported, that the iframe was not expanding correctly. This has been fixed and it will not expand to the entire available space of your widget.

Fixed compile & runtime warnings

We were still using deprecated imports, which caused warnings in the browser. This has been fixed and your console will no longer contain them.

What's Changed

Full Changelog: https://github.com/ajnart/homarr/compare/v0.12.0...v0.12.1

v0.12.0

1 year ago

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

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.

image

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 !!!

Multiple RSS feeds

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

image

Tab refresh / close confirmation

Since some have lost their changes, by refreshing the page in the edit mode, we've implemented a popup that will ask your browser to confirm the page change from the user:

image

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 calender

In 0.11.5 and previous versions, the calender scaled really bad 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:

  • DOCKER_HOST
  • DOCKER_PORT

What's Changed

New Contributors

Full Changelog: https://github.com/ajnart/homarr/compare/v0.11.5...v0.12.0