Skip to main content

Custom Icons for Services

How are icons requested?​

The icons used in Homarr are automatically requested from the dashboard-icons repo.

Icons are requested in the following way:

  1. Grab Name
  2. Replace " " with "-"
  3. Convert to lowercase
  4. Insert in link: https://cdn.jsdelivr.net/gh/walkxhub/dashboard-icons/png/{name}.png

firefox_vCMTN5meLp

Adding your own icon(s)​

1. Mounting the icon folder​

Mount the /app/public/icons folder of your docker container.

image

2. Adding custom icons​

Add any icon(s) to the folder. If you're using unRAID, connect using SMB or (S-)FTP.

3. Restart your docker container​

Currently, a restart of the Homarr container is required to being able to load icons from the frontend. Simply restart it after adding your desired icons to the folder.

4. Use your icons for services​

Access the icon(s) using /icons/name.png or /icons/name.svg.

image

info

If you're unable to load your cusotom icons, make sure that you've set the permissions correctly. Running chmod 755 /app/public/icons -R might resolve the issue.