Homarr on UNRAID
Hi All,
I am new to Homarr and have just installed it on my UNRAID server via Community Applications.
No issues setting up and the docker image appears to be working correctly.
I have been watching some guides on YouTube on how to setup a board but I am finding my version of Homarr looks very different to that of the guides. Things appear to be missing e.g. adding Intergations to a board/adding sidebars.
It seems like I am not the only one as many comments in the below video express options missing/looking different....

Pihole v6 not using trusted certificates
Hi
For me the pihole v6 is not connecting at all, due to changes in pihole, most of the users will now have a selfsigned cert and https mode instead of http, I guess that's the problem too for me, how can I enable connections to unverified (seflsigned) https certs?
Also a little side note, I think in piholev6 it's not called api password, it's just the login password, except one specifically creates an app passwort....
Solution:
OMG I screwed up and used
fetch
instead of fetchWithTrustedCertificatesAsync
in the factoryPi-Hole errors Failed to control DNS Hole and Failed to fetch DNS Hole Summary
Getting the below error from Pi-hole.
2025-03-06T18:11:00.520Z error Failed to run integration job integration=q7xvfx2jyk9gvido95vjjg0x inputHash='W3t9XQ==' error=TypeError: fetch failed
at node:internal/deps/undici/undici:13502:13
at async Array.createPiHoleIntegrationAsync (/app/apps/tasks/tasks.cjs:466956:20)...
Solution:
I fixed it by pointing it at my pihole IP. Thank you
Integration Querying in Pihole
Yesterday I upgraded from the old Homarr. I set up my integrations with the calendar, download client and DNS hole controls and summary. I've noticed that my Pihole stats have shifted greatly since I set up those integrations.
When I checked Pihole itself, it was showing that the integrations with the calendar were querying every integration I connected to it every minute. It would do the same thing with each integration for download client and DNS hole control and summary, but for every 5 seconds. When I checked the last hour, it was showing the dashboard sent 19,638 requests.
I know it wasn't like this with the old version. Is this the new normal?...
a client-side exception has occurred
when i go to port 7575 (homarr), it sends a failed to connect to websocket and "a client-side exception has occurred " on the webpage
Abort Error
im not sure how to fix this, i was setting up samba and it messed up a bunch of things like ssh and me having to allow everything using ufw, including homarr integrations/widgets, any help is appreciated.

Update with docker-compose pull performed but remains blocked in 1.7.0 although it is well pull
Hello,
I have a problem with my Homarr, it is well updated with docker-compose pull but remains blocked in 1.7.0 whereas it is well pull. Could you help me because I don't know what to do.
I remembered to stop and start it....
Solution:
- Your docker pulled the correct image and "downloaded"
1.9.0
- Your container is likely still running (or was running) with the old image
- You are using docker-compose
, which is the old version and deprecated. Use docker compose
instead. See https://homarr.dev/docs/getting-started/installation/docker#updating for further information....
PiHole v6 Integration not accepting app password
Running 1.9.0 on Unraid.
I did have the previous v5 integration setup without any issues before updating the PiHole and of course I've been looking forward to this release.
When I edit my integration for PiHole and supply the new app password, when testing the connection I just get "The integration could not be saved."...
Solution:
So, I did a little bit more poking with the matter and also ran
pihole -r
just to make sure everything was all good on the piholes end, and I managed to get it functioning. Specifically the integration points to http://192.168.0.5:8080
and that got everything working without the need to delve into certificates, which saves me from needing to go on a learning deep-dive while the wife is yelling at me to help with the cooking 😄 The widget on the homescreen works, accessing the pi-hole via the app button works and the ping works too.
Just wanna say thanks to you folks for your help in poking me in the right direction and for all your hard work on homarr. I'm positively drooling looking forward to that scaling release on Friday. Thanks again!...
Forward auth support
Hey there! I was looking through the docs and was looking through the authentication options, and saw that there was support for LDAP, OIDC, and default credentials, but didn't see any mention of forward auth. Is this supported at all? I'd like to require auth with authelia, and then have homarr get the username/group information from the Remote-User & Remote-Group/x-forwarded-user, is that currently possible?
Solution:
No it is not, but you obviously can setup OIDC for Authelia and on the login page automatically redirect to authelia with
AUTH_OIDC_AUTO_LOGIN=true
502 Bad Gateway Error occurs when Navigating the Admin Interface.
Hey, I am a complete newbie and setting up my first home server from an old PC right now using Ubuntu Server. I am experiencing a recurring issue with the Homarr admin interface. When navigating through the interface, I frequently encounter a "502 Bad Gateway" error. Sometimes, before this error, there is an "Application Error: Client-Side Exception has occurred (See the browser console for more information)." message. I have attached screenshots of both errors to this ticket.
This issue prevents me from editing and saving changes. Whenever I input text (for example, when editing an app's description or name) and press "Save," I encounter the "502 Bad Gateway" error, and my changes are not applied.
I have installed Homarr via Docker using the latest image. I have already searched for others experiencing the same problem, but all related tickets I found are at least two years old or older.
Please let me know if you need any additional information, such as logs or other details....
Solution:
Okay I think sadly your CPU does not support the instructions required to run the latest nodejs version. So you will either need to update your CPU or not run Homarr...

When selecting apps on the dashboard, I can only see 10 out of 20 apps on the list.
What the title says. It will not display the rest apps to choose from.
Solution:
Can't ping my apps
So while I was setting up my server I was using the PC's WiFi adapter and was using host local ip address as app URL & Ping address. Now I finished setting it up, changed to ethernet, changed the apps' address & ping URL, but I'm not getting any ping even though the apps are working like before.
This is from the 'docker logs homarr'
https://logs.notifiarr.com/?5a6211c109dbeee1#FivNFgcWQbJbc3SH3bHnxhFYtZrA7q4dhkMCLXz13HWB...
Solution:
I fixed it by setting rules for the ports in ufw (eg sudo ufw allow 32400/tcp)
Icon Change Ping
Hello, I recently switched to the latest version of Homarr. The display has changed slightly and evolved. I would like to know if it's possible to have different icons, for example, the color dots that existed and were more visible than they are now. Perhaps through CSS or loading an icon via an external URL? Thank you for your work.
Regards....
Solution:
Hi, yes you can change to icons in the new Homarr too. It could be useful if you're red-green colorblind. As mentioned, this can be used in both 0.15.10 and 1.0.0+ .

Icons not downloaded on install
so i just installed homarr, got it up and running and everything but when i went to install i got an error loading the icons and it did not download any icons.
Overseerr Issue
Homarr 1.8.0
OS : Ubuntu 24.04
I can setup Overseerr as an application and click on the icon successfully, but I cannot set it up as an integration. I believe it doesn't like the API key, but that's just my opinion.
...
Search integration error
I am trying to use searxng (https://github.com/searxng/searxng) since it uses opensearch, but when i add it to homarr and try to use the search bar it gives me an error: "An error occurred while fetching data".
any idea how to fix it?
Using docker compose
Ubuntu 24.04.01...
Network settings for apps
I just migrated to v1.0 and have a few apps that require additional http status codes. This used to be easy in the app section for 'Network' I could easily add codes to treat as valid on pings. I have looked all over the new UI, and can not find this function anymore. Is it there and I missed it - soemwhere?
Thanks.......
Solution:
Hi @Paul R , thanks for the question. We removed this setting because Homarr 1.0 is a complete rewrite. The name "ping" also implies that we perform a single ping - not a HTTP status check.
We will re-add a similar integration with Uptime Kuma (https://github.com/louislam/uptime-kuma) in a later version, where you can monitor HTTP status codes again.
Does this answer your question?...
Proxmox integration error in 1.7.0
Been running fine until I just restarted my docker host and now I don't get any proxmox cluster stats.
When I add a new API key I get the following error when I click test connections and save:
Internal server error...
Solution:
it's always DNS. 😆
I had gone a bit mad in my pihole config and had created a DNS loop. All resolved, as you were 🫡...
Page Title/ Logo removal?
Hey, I might be missing something, but is there a way to remove the page title (that top-left text) and the logo that comes with it? I've figured out how to rename it, but I haven't found any options to hide or remove it.
I assume it might be something with CSS, but I'm not sure how to do that at the moment....