# Unraid Icons

Unraid Icons is a self-hosted plugins app. A shared icon library for Unraid VMs and Docker containers. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/7667/unraid-icons

## Description

A shared icon library for Unraid VMs and Docker containers. Browse application logos from selfh.st and Dashboard Icons, choose symbols from Iconify, or import a custom image URL. Download icons once and select them from the VM and Docker editors. Optional integrations support Compose Manager Plus and FolderView3. Manage downloaded icons under Settings → Icons. Downloaded icons and preferences are retained across updates, reboots, and plugin removal.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

42/100 (Fair), based on 3 of 4 factors.
- Maintained: 72 (last commit 31 days ago)
- Popular: 6 (1 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)

## Links

- Unraid: https://ca.unraid.net/apps/app_5ede52cdeb613b83
- GitHub: https://github.com/Lanjelin/unraid-icons

## Common questions

### How do I install unraid-icons on Unraid?

Use Plugins → Install Plugin and enter the direct plugin URL, or copy the plugin file to /tmp/unraid-icons.plg on the server and run plugin install. The package is self-contained and does not fetch additional plugin code or packages, and it reports missing PHP extensions instead of installing them.

### Are downloaded icons and settings kept after updates, reboots, or removal?

Downloaded icons and preferences are retained across updates, reboots, and plugin removal. You manage downloaded icons under Settings → Icons.

### Can I use the downloaded icons outside the native VM and Docker container editors?

Optional integrations support Compose Manager Plus and FolderView3. You download an icon once and then select it from supported editors.

### Does an Iconify icon color change when I switch Unraid themes?

No, the chosen Iconify color is baked into the saved transparent 512 × 512 PNG. The image is converted in your browser, validated, and stored on the server, so it does not change when Unraid themes change. If needed, download another color.

### Can I import a custom icon from an image URL?

Open Settings → Icons → Custom URL and enter a direct public image URL or a base64 PNG data URL. Public URLs must point directly to the image; public URLs support PNG, JPEG, GIF, and WebP where the server supports them, while data URLs support base64 PNG only. All imports are saved as PNG, animated images become one frame, and the 8 MiB maximum is measured after base64 decoding for data URLs.

---
Source: Our Local Host (https://ourlocalhost.com/app/7667/unraid-icons), the self-hosted and open-source app directory.
