Hey everyone,

I have configured my docker containers using docker compose and after having recently figured out that I am able to integrate those containers into the Unraid interface using labels, I've added the following section to all my compose files:

    labels:
      net.unraid.docker.webui: 'http://[IP]:[PORT:7575]'
      net.unraid.docker.icon: 'https://cdn.jsdelivr.net/gh/walkxcode/dashboard-icons/png/homarr.png'

With those labels, I was able to link to the Web UI, but unfortunately the icons do not appear. I would like to know if someone knows what I have to change to make those icons appear in the GUI.

I've always done what you've shown there in my docker-compose.yml file and it worked previously. I always had weird issues where once you set it, and the image was built you could never change it no matter how many times you changed the URL itself.

I've now just created two dockers from scratch with the label set correctly and the images haven't shown. Unsure exactly what's happening.

Just having this same problem, a year later. I've tried to find references to whether it was fixed, or if it's a case of fileformat for the icon or something, but haven't been able to. Don't suppose either of you know what the status is?

if the dns fails to access the web link you need to make a file location local and specify the unraid host file access to the png file.

I have yet to have a issues using compose and the label sytem to add additional docker metata data to the web ui.

Example Of What I use in my compose for unraid docker web UI intergration.

the icon can be a local path of /mnt/user/appdata/icons/name.png and still work...

I can only asume at time of refresh the png file was not accessible...

    labels:
      net.unraid.docker.icon: 'https://raw.githubusercontent.com/imagegenius/templates/main/unraid/img/immich.png'
      net.unraid.docker.webui: http://[IP]:[PORT:2283]
      folder.view: immich
      net.unraid.docker.managed: 'composeman'

also if you manual edit the stack UI it will override the compose file info.
or have the compose file fill it once then edit the compose file... it will not update form the compose as ui labels hav been filled. ther is no relaod and update you must clear or edit the UI Labels manualy at that point...

Double check that you are using the compose file to fill in once otherwise you need to empty the UI labels. and edit the comspe and save again to repopulate...

Hello,

I have just started using Unraid, and I can't get the docker tab or the dashboard to show a custom icon when I use docker compose through dockge to deploy a container.

    labels:
      net.unraid.docker.icon: 'https://github.com/actualbudget/actual/raw/master/packages/desktop-electron/icons/icon.png'
      net.unraid.docker.webui: http://[IP]:[PORT]

I have followed the naming as other users pointed out, and doesn't seem to work anymore. As @Cball said, the docker.webui label works but the docker.icon doesn't.

On 4/1/2026 at 1:26 PM, YoussefAFdez said:

Hello,

I have just started using Unraid, and I can't get the docker tab or the dashboard to show a custom icon when I use docker compose through dockge to deploy a container.

    labels:
      net.unraid.docker.icon: 'https://github.com/actualbudget/actual/raw/master/packages/desktop-electron/icons/icon.png'
      net.unraid.docker.webui: http://[IP]:[PORT]

I have followed the naming as other users pointed out, and doesn't seem to work anymore. As @Cball said, the docker.webui label works but the docker.icon doesn't.

In response to my own message, I kept trying with other services, and it somewhat works:

I'm not sure of the criteria, what I do to get the images is go to the App tab in unraid, search for the app, click install, then advanced (top right) and copy the icon route.

labels:
      net.unraid.docker.icon: "https://raw.githubusercontent.com/selfhosters/unRAID-CA-templates/master/templates/img/vaultwarden.png"

This is an example of the line for vaultwarden. I don't know if it neets to be a raw.githubusercontent path, or if the icon needs to have a name that matches the container. But I believe this is some cool info. Hope it helps someone.

Thank you so much for the yaml labels - worked perfectly for me. I just added an extra label in the unraid setup and boom I’ve got my custom icon. You rock!

I had the same issue with icons not loading. But just now I tried downloading the icon, storing it in the appdata-folder of the app and pointing the label to there. It worked straight away.

So looks like it's an issue with reaching out to the specified URL for the icon.