Homarr not working at all as of 9/24/25
Homarr was working perfect until mid-day of yesterday, now no matter what it wont load homarr, keep getting 500 error, I tried spinning it up with my yaml and doing the docker run way, every single service works except homarr. Looking ovwr the logs in portainer, it keeps showing homarr is trying to ping a redis at 127.0.0.1, and then I used AI to help me troubleshoot and it told me to add redis to my yaml and still could not get homarr to work, spent 6hrs on this yesterday, using the latest homarr image. Any help would be appreciated i tried it with putting it behind my proxy and removing the proxy and just declaring the ports to see if i could acces that way and also could not. I also already have the DNS entries in my Unifi OS and in npm, all services work except this one. I redacted information on the yaml.
My yaml:
Solution:Jump to solution
Your file system permissions and UID / GUID are incorrect. Please see https://homarr.dev/docs/next/advanced/running-as-different-user/ .
Since Homarr also interacts with the Docker Socket, the setup is a bit more complicated than for other containers....
Running as a different user | Homarr documentation
By default the container is running with user root and group root.
30 Replies
Thank you for submitting a support request.
Depending on the volume of requests, our team should get in contact with you shortly.
⚠️ Please include the following details in your post or we may reject your request without further comment: - Log (See https://homarr.dev/docs/community/faq#how-do-i-open-the-console--log) - Operating system (Unraid, TrueNAS, Ubuntu, ...) - Exact Homarr version (eg. 0.15.0, not latest) - Configuration (eg. docker-compose, screenshot or similar. Use ``your-text`` to format) - Other relevant information (eg. your devices, your browser, ...)
Frequently Asked Questions | Homarr documentation
Can I install Homarr on a Raspberry Pi?
here are the logs from portainer
after deploying the yaml i also see this in portainer under environment variables, some of these entries are not even in my yaml:
Your Redis connection is down
Please fix the Redis connection or use the internal provided Redis
The risk of using external Redis is that Homarr will be unable to serve any requests, since the new version (1.0+) heavily depends on it
how do i do that? up until mid day yesterday, i didnt even have to have a redis delcared in the yaml
apologies im not well versed in this
You've configured external Redis here:
If you didn't do this change, it's likely that someone else made this change.
i removed those entries as well and cannot access
Essentially, Homarr will just try to connect to this hostname and port. If it fails, Homarr will be unable to show anything or perform any integration connections
Then please
- repost your YAML with all non-Homarr relevant services removed for clarity
- repost your Homarr logs online, e.g. on Pastebin
k moment
homarr only yaml: # ========= NETWORKS ========= #
networks:
proxy:
driver: bridge
ipam:
config:
- subnet: 172.31.0.0/24
top-level declaration of all named volumes #
volumes:
homarr_data:
services:
# ===== Homarr ===== #
homarr:
container_name: homarr
image: ghcr.io/homarr-labs/homarr:latest
restart: unless-stopped
environment:
- PUID=1000
- PGID=1000
- TZ=America/Chicago
- SECRET_ENCRYPTION_KEY=redacted
volumes:
- homarr_data:/appdata
- /var/run/docker.sock:/var/run/docker.sock # This must remain a bind mount
ports:
- 7575:7575
Please post as a code block: https://support.discord.com/hc/en-us/articles/210298617-Markdown-Text-101-Chat-Formatting-Bold-Italic-Underline
Also, can you please explain what you have changed since 24.09? Do you use Watchtower or any other automatic deployments / security management?
yes i added watch tower a few days ago
Ok. I will wait until you've formatted correctly and provided the logs.
hopefully i did this right: https://pastebin.com/Mu1dBTCS
Pastebin
homarr - Pastebin.com
Pastebin.com is the number one paste tool since 2002. Pastebin is a website where you can store text online for a set period of time.
Please let me quickly review it...
np
Solution
Your file system permissions and UID / GUID are incorrect. Please see https://homarr.dev/docs/next/advanced/running-as-different-user/ .
Since Homarr also interacts with the Docker Socket, the setup is a bit more complicated than for other containers.
Running as a different user | Homarr documentation
By default the container is running with user root and group root.
The problem will be fixed as soon as those messages are no longer being logged. It means that Homarr cannot scaffold the database and some essential config files, because it does not have permission
ok so remove those 2 entries
Yes, removing them is one option. Your container will run as root then
the PGID and PUID?
im very confused as to why this was working 100% fine and then randomly stopped
Yes, to run as root, remove:
And chown or chmod the filesystem if needed.
I don't know either, since we didn't change anything about this lately.
I think your Watchtower or someone else changed it or your filesystem had it's permissions changed
Also, this would be a good time to perform a backup of all directories on the file system (the Homarr directories). It is always a good practice to have at least 2 copies on another system with multiple revisions.
Backblaze Blog | Cloud Storage & Cloud Backup
Backup Strategies: Why the 3-2-1 Backup Strategy is the Best
A Backblaze survey revealed 54% of people said they know someone or have themselves recently lost data. Find out what you can do to prevent data loss.
i removed those 2 lines and homarr popped up instantly now, how did chatgpt, claude and gemini not catch that, they even gave me the recommendation to add those 2 lines
Because most AI agents have not been trained for Homarr and AIs often hallucinate
I appreciate you so much
I recommend you to use the official Homarr AI (by kappa) to ask Homarr related questions
But it too cannot catch all errors and mistakes. Feel free to ask again if you have issues.
Also, I'll just leave this here for your information:
!qa 321
The 3-2-1 backup strategy is the recommended backup strategy for most users, including for Homarr users. Please see https://www.backblaze.com/blog/the-3-2-1-backup-strategy/ for more information and instructions. It is important to create backups regularily of Homarr data, in case an automatic update breaks something, a user accidentially deletes data or in case of data loss.
To backup Homarr data, simply copy all the mounted directories or volumes to your desired destination (if possible to at least one other host). Homarr 1.0+ does not offer a data export in the UI. The data can be stored unencrypted, since passwords and secrets have been encrypted with the secret encryption key. Be sure to backup the secret encryption too in a separate location (e.g. your password manager).
Backblaze Blog | Cloud Storage & Cloud Backup
Backup Strategies: Why the 3-2-1 Backup Strategy is the Best
A Backblaze survey revealed 54% of people said they know someone or have themselves recently lost data. Find out what you can do to prevent data loss.
Can I now close this issue and mark it as resolved?
yes thank you