Customizable browser's home page to interact with your homeserver's Docker containers (e.g. Sonarr/Radarr)
MIT License
Bot releases are visible (Hide)
[!NOTE]
We've been working actively on working torwards version 1.0 which will include many improvements to performance, security and the overall look & feel of Homarr. It will greatly overhaul the technical architecture of Homarr. This work is done by volunteers. Please consider supporting our work via donations at https://opencollective.com/homarr
0.15.1
, even though you were running 0.15.1
Full Changelog: https://github.com/ajnart/homarr/compare/v0.15.1...v0.15.2
Published by manuel-rw 7 months ago
[!NOTE]
We've been working actively on working torwards version 1.0 which will include many improvements to performance, security and the overall look & feel of Homarr. It will greatly overhaul the technical architecture of Homarr. This work is done by volunteers. Please consider supporting our work via donations at https://opencollective.com/homarr
AUTH_OIDC_SCOPE_OVERWRITE
to override the OIDC scopesAUTH_LDAP_SEARCH_SCOPE
to modify the LDAP search scope between base
, one
or sub
.@hillaliy has contributed a new system health widget that integrates with https://www.openmediavault.org/
The weather widget can now display a weekly forecast:
We have added Lithuanian and Estonian to Homarr. As always, our community can translate Homarr into these languages:
https://crowdin.com/project/homarr
Thanks to our contributors, the torrent widget now uses virtualization to lower the required work on the client when rendering the list of torrents. This results in more fluid scrolling and resizing of the widget:
https://github.com/ajnart/homarr/assets/162878798/8a21eec2-2f6e-4b0b-8653-7cd730d7d697
Ordering columns is also now possible:
Full Changelog: https://github.com/ajnart/homarr/compare/v0.15.0...v0.15.1
Published by manuel-rw 8 months ago
Thanks to @Rikpat 's contribution, Homarr finally supports single sign on.
It is also possible to use both providers at the same time and disable the credentials entirely.
Please read the documentation on how to set this up: https://homarr.dev/docs/advanced/sso
You can now manage your Prowlarr indexers from Homarr and see their status:
Values can now optionally be displayed with a unit:
Full Changelog: https://github.com/ajnart/homarr/compare/v0.14.5...v0.15.0
Published by manuel-rw 9 months ago
We had a regression in 0.14.5 that caused the docker button to be hidden in some cases.
This hotfix is a forward fix for this issue and should show the docker button again.
We're sorry for the inconvenience.
Full Changelog: https://github.com/ajnart/homarr/compare/v0.14.5...v0.14.6
Published by manuel-rw 9 months ago
We had an accidental regression where the loading times of the docker containers were significantly increased.
This issue has been fixed and loading times should be better now.
We've introduced a new button to duplicate apps on your board:
This is not yet available for widgets.
It is now possible to use a video for the background in Homarr.
Full Changelog: https://github.com/ajnart/homarr/compare/v0.14.4...v0.14.5
Published by manuel-rw 9 months ago
Want to toggle your lights? Have a fun to switch on? Or maybe you want to send a reminder to your family?
We've upgraded the existing entity state widget and added a new widget that support invoking automations on your Homeassistant.
Homeassistant's vast library of integrations enable you to make complex workflow that can be easily started with a single click from Homarr:
We've improved the layout for smaller screens and significantly cut down the bandwidth required for the torrent widget.
This should result in less lag and faster updating on your widget.
We've heard you: boards can now be renamed / or duplicated. You don't need to mess with any files on the filesystem.
We know that there are many advanced users who want to take better control of Homarr's capabilities.
Therefore, we've added a JSON API that can be used to execute almost any action that you can from the WEB UI.
We provide an Open API specification document that enables you to easily browse your API endpoints:
Previously, the local icons were hard to use and had the wrong path by default.
We have fixed this problem and added the size of the file as an additional information.
@tancak has contributed the displaying of availability information on requests:
Full Changelog: https://github.com/ajnart/homarr/compare/v0.14.3...v0.14.4
Published by manuel-rw 10 months ago
Thank you for all your support in 2023 - we really appreciate it.
Homarr has been downloaded almost 4 million times with over 400'000 instances running the latest versions.
Due to the increase in traffic, we have upgraded our website at https://homarr.dev/ significantly and moved our infrastructure to a hosting provider.
We are looking forward to see you in 2024!
Thanks to @InterN0te , our torrent widget has received a great upgrade:
Homarr now integrates seamlessly with Gravatar. Simply upload a profile picture to Gravatar and you're good to go!
We've added back the Docker integration to your boards.
It's now easier to use than ever.
Did you get locked out? Using our CLI tool, you can reset your password to recover your Homarr instance:
Full Changelog: https://github.com/ajnart/homarr/compare/v0.14.2...v0.14.3
Published by manuel-rw 11 months ago
The long awaited Home Assistant integration is finally here. You can display almost any entity from your Home Assistant instance within a few clicks. Further information and guide how to set up: https://homarr.dev/docs/widgets/home-assistant/
You can now share your dashboard in our official subreddit.
Please note that we will delete posts asking for support or reporting bugs - the official site for reporting them is still here on GitHub.
But we are very happy to see tons of your configurations, hardware setups, boards and cool setups! π
https://www.reddit.com/r/homarr/
In 0.14.1, we introduced a bug with the notepad widget.
This has been resolved and you can delete said widget again.
We also fixed several other bugs and log messages.
Full Changelog: https://github.com/ajnart/homarr/compare/v0.14.1...v0.14.2
Published by Meierschlumpf 11 months ago
During the last release, we didn't spend enough time to test on different hardware configurations to ensure that v0.14.0 would work on the majority of people's hardware and it seems to have caused major issues with some people, we apologize for this inconvenience.
This update brings major bug fixes as well as protection layers and adjustments to address these issues and improve the stability of homarr. In addition to that, we fixed some small problems with the UI and other docker-related fixed, using a socket-proxy now works again.
With this update, your instance is expected to run again without any problems.
If this is not the case, please contact us directly via GitHub or Discord.
Full Changelog: https://github.com/ajnart/homarr/compare/v0.14.0...v0.14.1
Published by ajnart 11 months ago
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 β or you could also make a donation
Either would go a long way to support homarr β€οΈ
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'
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.
We've updated the dashboard user interface to an updated design.
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.
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 :
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:
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.
[!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:
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 ! π₯
tw
by @ajnart in https://github.com/ajnart/homarr/pull/1518
crossorigin="use-credentials"
by @ajnart in https://github.com/ajnart/homarr/pull/1528
Full Changelog: https://github.com/ajnart/homarr/compare/v0.13.4...v0.14.0
Published by Meierschlumpf about 1 year ago
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.
Full Changelog: https://github.com/ajnart/homarr/compare/v0.13.3...v0.13.4
Published by manuel-rw about 1 year ago
Full Changelog: https://github.com/ajnart/homarr/compare/v0.13.1...v0.13.3
Published by ajnart about 1 year ago
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.
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!
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.
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.
You can now specify the layout of the dns hole as you want. We added support for vertical and horizontal layouts.
Full Changelog: https://github.com/ajnart/homarr/compare/v0.13.1...v0.13.2
Published by manuel-rw about 1 year ago
We are excited to introduce the latest version of Homarr, packed with bug fixes, improvements to the Bookmark widget and several other design enhancements.
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.
We made the app name hideable and created the possibility to put it on the side you want.
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:
hr
locale ππ· by @ajnart in https://github.com/ajnart/homarr/pull/1202
Full Changelog: https://github.com/ajnart/homarr/compare/v0.13.0...v0.13.1
Published by ajnart over 1 year 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:
ποΈ 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.
πΈ 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.
β¨ 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.
π 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
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:
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.
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.
package.json
prettier and eslint by @ajnart in https://github.com/ajnart/homarr/pull/1046
yarn
by @ajnart in https://github.com/ajnart/homarr/pull/1062
Full Changelog: https://github.com/ajnart/homarr/compare/v0.12.3...v0.13.0
Published by manuel-rw over 1 year ago
The iframe supports now more permissions:
You can now open bookmarks in a new tab:
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:
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.
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.
In 0.8, the Jellyfin migrated to ES modules. This causes Homarr to break partially.
We mitigated the issue by transpiling the dependency correctly.
The API for Dash. was broken by a newer version of Dash.
We have updated our implementation and it will display your storage again.
calendar
widget by @ajnart in https://github.com/ajnart/homarr/pull/963
tanstack/react-query
by @ajnart in https://github.com/ajnart/homarr/pull/944
Full Changelog: https://github.com/ajnart/homarr/compare/v0.12.2...v0.12.3
Published by manuel-rw over 1 year ago
0.12.2
comes with a bunge of improvements for existing systems but also two big new widgets for your dashboard:
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:
Using the visual editor, changes can be made easily and fast:
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:
There's also a second widget, that can disable and enable your instances with one click:
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:
Are you running IPv6? Previously, Homarr did not support those.
Now, your apps should work like expected with IPv6.
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:
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.
@tabler/icons-react
by @ajnart in https://github.com/ajnart/homarr/pull/914
Full Changelog: https://github.com/ajnart/homarr/compare/v0.12.1...v0.12.2
Published by manuel-rw over 1 year ago
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.
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.
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.
We have fixed the video stream widget, so it can play now any supported file type.
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.
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.
We were still using deprecated imports, which caused warnings in the browser.
This has been fixed and your console will no longer contain them.
Full Changelog: https://github.com/ajnart/homarr/compare/v0.12.0...v0.12.1
Published by manuel-rw over 1 year ago
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:
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.
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'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 !!!
You can now consume multiple RSS feeds at the same time:
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:
You can now set the default color scheme using environment variables:
DEFAULT_COLOR_SCHEME
= [dark, light]
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.
We've migrated Mantine to version 6. This will bring some upstream changes for responsiveness and usability.
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.
We now use several methods to improve performance and reduce network requests.
Homarr will load now within milliseconds and cache data in your browser.
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
Full Changelog: https://github.com/ajnart/homarr/compare/v0.11.5...v0.12.0
Published by manuel-rw over 1 year ago
As many of you have requested, Homarr has now a fancy integration for your Plex and Jellyfin instances:
It supports multiple instances at the same time and displays useful information about your sessions.
We plan to add more information in future releases, according to your feedback.
Did you ever come across a website or tool, that you wanted to integrate to your dashboard, but weren't able to?
Although this new widget doesn't integrate natively, it enables you to display most websites on your dashboard:
Note, that this may be limited to some websites, as many explicitly disallow iframes.
Reading news all the time? Or do you have a tool, that exposes information via RSS?
No problem, Homarr has now got you covered with the new RSS widget:
You can use almost any feed, that satisfies the RSS standard.
How much is too much?
We went all out and now you can pick from over 7'000 icons, directly from your dashboard:
It will now also display local icons much better.
Hurray! Homarr is now finally ready to be exposed to the public.
People can no longer make modifications, if you set the following environment variable to true: DISABLE_EDIT_MODE
.
Please note, that this is experimental, and requires a restart of the container.
We'll remove this in the future, when a more advanced authentication and authorization structure has been implemented.
Are you running a few web cams around your house?
Or maybe just watching your favorite stream?
Homarr has now an integration of https://videojs.com/ .
You can integrate any stream or video, that is being supported by video js.
Full Changelog: https://github.com/ajnart/homarr/compare/v0.11.4...v0.11.5