v0.15.0

SSO (LDAP, OIDC)

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

New widget: Indexer manager

You can now manage your Prowlarr indexers from Homarr and see their status:

Units for the home assistant widget

Values can now optionally be displayed with a unit:

What's Changed

• fix: attempt to fix hidden docker button by @manuel-rw in #1875
• chore: new Crowdin updates by @ajnart in #1873
• config: chore version by @manuel-rw in #1876
• docs: add argos ci to readme by @manuel-rw in #1883
• fix: Notebook link target bug fix by @Tagaishi in #1889
• fix: Board create name bug fix by @Tagaishi in #1887
• feat: added features to smart home entitiy card by @tuggan in #1844
• feat: indexer manager by @hillaliy in #1807
• fix: remove url length checks in Bookmarks by @ajnart in #1851
• chore: new Crowdin updates by @ajnart in #1878
• feat: add SSO support (LDAP, OIDC) by @Rikpat in #1497
• docs: update README.md by @ajnart in #1892
• config: tag release by @manuel-rw in #1906

New Contributors

• @Rikpat made their first contribution in #1497

Full Changelog: v0.14.5...v0.15.0

v0.14.6

Hotfix for the Docker integration

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.

What's Changed

• fix: attempt to fix hidden docker button by @manuel-rw in #1875
• chore: new Crowdin updates by @ajnart in #1873
• config: chore version by @manuel-rw in #1876
• version 0.14.6 by @manuel-rw in #1877

Full Changelog: v0.14.5...v0.14.6

v0.14.5

Docker loading times

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.

Copy apps

We've introduced a new button to duplicate apps on your board:

This is not yet available for widgets.

Video background

It is now possible to use a video for the background in Homarr.

What's Changed

• config: update stale.yml by @manuel-rw in #1847
• feat: updated EntityStateSchema for homeassitant by @tuggan in #1843
• feat: add Video Background Support by @spkesDE in #1839
• chore: new Crowdin updates by @ajnart in #1834
• feat: #1835 copy apps by @manuel-rw in #1854
• fix: rss widget post sorting by @manuel-rw in #1855
• fix: remove console log by @manuel-rw in #1861
• fix: #1805 remove server prefetching docker by @manuel-rw in #1860
• chore: new Crowdin updates by @ajnart in #1862
• chore: increase version by @manuel-rw in #1867
• chore: new Crowdin updates by @ajnart in #1869
• fix: #1859 dayjs locale translation by @manuel-rw in #1868

New Contributors

• @tuggan made their first contribution in #1843
• @spkesDE made their first contribution in #1839

Full Changelog: v0.14.4...v0.14.5

v0.14.4

Deeper integration in Home Assistant

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:

Improved layout & performance for torrent widget

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.

Renaming & duplicating boards

We've heard you: boards can now be renamed / or duplicated. You don't need to mess with any files on the filesystem.

JSON API

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:

Fixed local paths in icon picker

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.

Availability of media requests

@tancak has contributed the displaying of availability information on requests:

What's Changed

• docs: updated dead installation links in README.md by @stark1tty in #1775
• refactor: improve torrent table design by @manuel-rw in #1786
• docs: fix documentation link URL after creating user by @StefanB7 in #1796
• feat: add availability information about media requests by @tancak in #1794
• feature: trigger automations by @manuel-rw in #1799
• feature: #1765 reduce transferred torrent data by @manuel-rw in #1798
• fix: database is not initialized inside the docker container by @anonysoul in #1806
• chore: increase version by @manuel-rw in #1811
• feature: improve admin security over dnshole controls by @Tagaishi in #1686
• feature: rss improvements by @manuel-rw in #1810
• feature: board operations by @manuel-rw in #1800
• revert: #1714 migrate to axios.get by @manuel-rw in #1819
• chore: new Crowdin updates by @ajnart in #1772
• feature: add trpc openapi by @manuel-rw in #1818
• refactor: optimize imports by @manuel-rw in #1822
• chore: New Crowdin updates by @ajnart in #1820
• fix: #1734 fix local icons path by @manuel-rw in #1821

New Contributors

• @stark1tty made their first contribution in #1775
• @StefanB7 made their first contribution in #1796
• @tancak made their first contribution in #1794
• @anonysoul made their first contribution in #1806

Full Changelog: v0.14.3...v0.14.4

v0.14.3

🎆🎆 Happy new Year!

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!

Better user management

Redesigned torrent table

Thanks to @InterN0te , our torrent widget has received a great upgrade:

Gravatar support

Homarr now integrates seamlessly with Gravatar. Simply upload a profile picture to Gravatar and you're good to go!

Updated docker integration

We've added back the Docker integration to your boards.
It's now easier to use than ever.

CLI tool

Did you get locked out? Using our CLI tool, you can reset your password to recover your Homarr instance:

What's Changed

• Update acceptableStatusCodes.ts by @jeffersonraimon in #1709
• ✨ #1616 Recovery script in Docker container by @manuel-rw in #1726
• 🐛 About page and manage user pages not translated by @ajnart in #1724
• ✨ Use gravatar with user email by @Tagaishi in #1688
• Switch torrents Table to MantineReactTable with filter/sort function by @InterN0te in #1557
• ⚡️ Improve code in manage layout page by @Tagaishi in #1681
• Updated entityStateSchema to handle nullables by @gfomichev in #1744
• feature/#1616 better user management by @manuel-rw in #1748
• New Crowdin updates by @ajnart in #1701
• fix: umlaute in RSS by @manuel-rw in #1755
• New Crowdin updates by @ajnart in #1761
• ⚡️ Remove location based timezone resolving by @Tagaishi in #1680
• Import to docker form board, Docker button on boards by @ajnart in #1714
• Update FUNDING.yml by @ajnart in #1768
• 🔧 Configure Stale Action by @manuel-rw in #1752
• 🔧 Configure greetings by @manuel-rw in #1753
• New Crowdin updates by @ajnart in #1770
• fix: outdated config schema by @manuel-rw in #1769
• chore: increase version in package.json by @manuel-rw in #1771
• Docker import fix by @ajnart in #1773

New Contributors

• @jeffersonraimon made their first contribution in #1709
• @gfomichev made their first contribution in #1744

Full Changelog: v0.14.2...v0.14.3

v0.14.2 Home Assistant and imprortant bugfixes

➡️ Home Assistant integration

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/

➡️ Official Reddit r/homarr to share dashboards or discuss new features

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/

➡️ Bug fixes for notepad and several other problems

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.

What's Changed

• ✨ Update GeneralTab.tsx by @No-Maines-Land in #1655
• 🐛 Migrate package.json has no license field by @Meierschlumpf in #1654
• 🐛 Link to definition of screen sized for edit mode notification wrong by @Meierschlumpf in #1652
• 🐛 Notebook edit button placed above edit mode settings by @Meierschlumpf in #1651
• ✨ Allow custom nextauth port by @tuxpizza in #1663
• New Crowdin updates by @ajnart in #1641
• ✨ Add support for installation in address bar by @Meierschlumpf in #1675
• New Crowdin updates by @ajnart in #1682
• 🐛 affix overlapping custom CSS box by @Tagaishi in #1687
• New Crowdin updates by @ajnart in #1692
• ✨ #698 homeassistant widget by @manuel-rw in #1658
• 🔖 Increase version by @manuel-rw in #1699
• ✨ Stale time for entity state by @manuel-rw in #1702

New Contributors

• @No-Maines-Land made their first contribution in #1655
• @tuxpizza made their first contribution in #1663

Full Changelog: v0.14.1...v0.14.2

v0.14.1 Stability improvement and bug fixes

Your issues should be resolved!

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.

What's Changed

• 🐛 Fix podman issue by @Meierschlumpf in #1586
• 🐛 Logo has no height and object-fit is not contain #1581 by @Meierschlumpf in #1584
• 🐛 Allow anonymous condition for default board by @manuel-rw in #1588
• 🐛 Placeholder width stretches out of screen by @Meierschlumpf in #1587
• ✏️ Corrected a typo in the Docker integration EN locale by @Lumilias in #1603
• 🐳 Fix docker TCP not working by @ajnart in #1607
• 🐳 Improve dockerfile and start script and fix permission issue by @Meierschlumpf in #1602
• ✨ Image properties customization by @manuel-rw in #1590
• 🌐 New Crowdin updates by @ajnart in #1572
• 🐛 customize page crashing for invalid board by @manuel-rw in #1610
• ✏️ Fixed typo in public/locales/en/settings/customization/page-appearance.json by @InterN0te in #1612
• ✏️ "," after the last language item in the about page by @benniblot in #1613
• 🐳 Fix issues with dockerfile by @ajnart in #1611
• 🐛 Header logo size fix by @Tagaishi in #1625
• 🔖 Bumb version to 0.14.1 by @Meierschlumpf in #1627

New Contributors

• @Lumilias made their first contribution in #1603
• @benniblot made their first contribution in #1613

Full Changelog: v0.14.0...v0.14.1

v0.14.0 The authentication update

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 ⭐ or you could also make a donation
Either would go a long way to support homarr ❤️

What's new?

• 🚀 Authentication system with users and invites
• ✨ Improved UI for boards (renamed dashboards to boards)
• 💻 Server side preferences makes it so dark mode and language are now synced across all your devices
• 🔗 Invitation links to easily onboard new users
• 👥 Allow guests to visit your dashboards or require users to have an account to interact with it
• 🧠 AI assistant powered by Kapa.ai on the documentation to answer your questions: https://homarr.dev/
• 🌐 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]
• 🐛 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.

⭐ New dashboard layout

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

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

---

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

What's Changed

• 🔖 Release v0.13.2 by @Meierschlumpf in #1262
• v0.13.2 - Hotfixed by @ajnart in #1274
• ♻️ Onboarding page by @manuel-rw in #1295
• 🐛 Fix locale for calendar and clock by @Tagaishi in #1330
• ✨Auth Page Dark/Light mode toggle button by @Tagaishi in #1265
• Version 0.13.3 by @manuel-rw in #1349
• ✅ Add tests for some tools functions by @Meierschlumpf in #1377
• ⬇️ next js 13.4.19 to 13.4.12 by @Tagaishi in #1376
• 🐛 env.port reporting NaN bug fix by @Tagaishi in #1375
• 🔀 Merge 0.13.4 to master by @manuel-rw in #1379
• ✨ Readd possibility to add containers as apps to boards by @Meierschlumpf in #1276
• 🩺 Added healthcheck to image and ARG for port by @devtobi in #1386
• 💄 Added modal for usenet widget by @Tagaishi in #1398
• 💄 Change modal for torrent widget by @Tagaishi in #1397
• 💄 Change modal for Calendar by @Tagaishi in #1396
• 💄 Change modal for media-server by @Tagaishi in #1395
• ✨ Hide DNS-Hole control buttons option by @Tagaishi in #1384
• 🐛 Calendar indicator over header bar fix by @Tagaishi in #1401
• Add autofocus for searchbar by @Meierschlumpf in #1408
• Feature/add allow anonymous switch by @manuel-rw in #1392
• 🐛 Download speed widget nzbget fix by @Tagaishi in #1400
• Feat/add login redirection by @manuel-rw in #1416
• ✨ Add basic authentication by @Meierschlumpf in #1227
• 🐛 Change position selector's dropdown bug by @Tagaishi in #1429
• New Crowdin updates by @ajnart in #1383
• Update step-onboarding-finished.tsx by @ajnart in #1437
• fix: stop triming traling slashes by @hskrtich in #1435
• 💄Allow user to make video stream smaller than 3*2 by @Tagaishi in #1430
• 🐛 Remove DISABLE_EDIT_MODE and replace with admin-procedure by @Meierschlumpf in #1439
• 🐛 Trim media server url by @manuel-rw in #1438
• Update weather.json by @AuthorShin in #1440
• 🐛 Database error with readonly mappings by @manuel-rw in #1420
• 🐛 Fix miscellaneous console errors by @Tagaishi in #1418
• 🐛 DNS-Hole error handling and fixes by @Tagaishi in #1419
• ♻️ Migrate from prisma to drizzle by @Meierschlumpf in #1434
• New Crowdin updates by @ajnart in #1433
• 🔒️ Fix tiptap url CVE by @manuel-rw in #1459
• Fix allow guest issue by @Meierschlumpf in #1472
• 🐛 Issue with migrate script for node 20 by @Meierschlumpf in #1467
• ✅ Add tests for invite router by @Meierschlumpf in #1456
• 🐛 Issue with migrate script in docker by @Meierschlumpf in #1483
• 🐛 Fix the leading slash when adding container via docker by @ajnart in #1478
• ✨ Improve customizations page load speed with SSR by @ajnart in https://github.com/ajn...

v0.13.4

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

• ⬇️ next 13.4.19 to 13.4.12 by @Tagaishi in #1370
• 🐛 Media Request List widget add new tab for item by @Tagaishi in #1362
• 🐛 Nextjs fix for later dependency by @Tagaishi in #1369
• ✨ Add a toggle to show unmonitored items in *Arr by @ajnart in #1371
• 🔖 Increase version to 0.13.4 by @manuel-rw in #1378

Full Changelog: v0.13.3...v0.13.4

v0.13.3

What's Changed

• 🔀 Version 0.13.1 by @manuel-rw in #1240
• ⏪ Revert line clamp by @manuel-rw in #1245
• ⏪ Revert line clamp (#1245) by @manuel-rw in #1246
• ✨ display location name on a weather tile by @ishaanparlikar in #1184
• 🥅 Add 404 error page by @manuel-rw in #1228
• 💄 Fix white space on torrent by @manuel-rw in #1254
• 🐛 App Transparency not used by torrent tile table by @Meierschlumpf in #1256
• ✨ Option to show time for a city by @Tagaishi in #1236
• fix: currentConfig not loaded in useEffect callback by @gnattu in #1250
• App tile flex fix by @Tagaishi in #1255
• 🐛 Issue with media request url by @Meierschlumpf in #1260
• 🐛 AdGuard Home time unit fix by @manuel-rw in #1005
• 💄DNS Hole Stats Flex layout and text fitting by @Tagaishi in #1261
• Notebook-widget by @ajnart in #962
• Fix issues with URL being too long when pinging many apps by @ajnart in #1264
• 🐛 Fix animation overflow by @manuel-rw in #1269
• New Crowdin updates by @ajnart in #1247
• 🥅 Add 500 catching page by @manuel-rw in #1226
• 🔖 Increase version to 0.13.2 by @Meierschlumpf in #1270
• 🐛 Added movie in icon list for currently playing by @Tagaishi in #1303
• 🐛 Plex tv-show formatting like jellyfin by @Tagaishi in #1304
• 🌐 Replaced hardcoded text to use translation by @Tagaishi in #1257
• 🐛 allow note only in edit mode by @manuel-rw in #1271
• ⬆️ Update dependency @react-native-async-storage/async-storage to v1.19.2 by @renovate in #1307
• ⬆️ Update dependency @types/react to v18.2.21 by @renovate in #1310
• ⬆️ Update dependency prettier to v3.0.2 by @renovate in #1308
• ⬆️ Update dependency video.js to v8.5.2 by @renovate in #1311
• ⬆️ Update nextjs monorepo to v13.4.19 by @renovate in #1293
• ⬆️ Update dependency @tabler/icons-react to v2.32.0 by @renovate in #1313
• ⬆️ Update dependency @types/node to v18.17.8 by @renovate in #1294
• ⬆️ Update dependency framer-motion to v10.16.1 by @renovate in #1314
• 🐛 RSS empty feed stuck on loading by @Tagaishi in #1331
• 🐛 fix flex for bookmark in firefox by @Tagaishi in #1346
• 💄 PiHole Summary Percentage Blocked Text by @Tagaishi in #1343
• 🐛 Page Metadata space char bug by @Tagaishi in #1340
• ⬆️ geo-tz to browser-geo-tz by @Tagaishi in #1322
• 💄 Large screen gridstack max value to 32 and sidebar gridstack over 13 bug fix by @Tagaishi in #1339
• Translation handling update by @Tagaishi in #1312
• 💄 Add custom font sizing for app name by @Tagaishi in #1341
• New Crowdin updates by @ajnart in #1272
• Bug/addguard-integration by @taos15 in #1306
• ✨ Rework Media Request Stats Widget by @Tagaishi in #1344
• ✅ Update vitest test for Pihole as sdk changed by @Tagaishi in #1352
• 🐛 'seerr search bug fix by @Tagaishi in #1350
• 🐛 Notebook scrollbar by @Tagaishi in #1342
• Fix enable/disable edit mode by @Willy-JL in #1333
• 🐛 Fix edit mode error in notebook by @manuel-rw in #1357
• 🐛 External URL being '' in media requests by @manuel-rw in #1355
• 🔖 Tag version to 0.13.3 by @manuel-rw in #1356
• New Crowdin updates by @ajnart in #1351
• 🐛Media Session widget jellyfin sessions + translations by @Tagaishi in #1353
• New Crowdin updates by @ajnart in #1358
• ⏪ Revert anchor colors in media request widget by @manuel-rw in #1360
• fix: log properties instead of object by @manuel-rw in #1361

New Contributors

• @ishaanparlikar made their first contribution in #1184
• @gnattu made their first contribution in #1250
• @taos15 made their first contribution in #1306
• @Willy-JL made their first contribution in #1333

Full Changelog: v0.13.1...v0.13.3