vm_custom_icons

vm_custom_icons

Docker app from SpaceInvaderOne's Repository

Overview

Custom VM Icon Manager v2 gives you a standalone web GUI to browse, preview and choose from roughly 90 VM icons, organised into macOS, Windows, Linux, FreeBSD and Other sections, plus a Custom upload area so you can add your own icons as well. It installs directly into Unraid’s VM Manager. Simply set the container to auto-start and your selected icons remain persistent and reload on every reboot.

unraid_vm_icons

A docker container that downloads and installs additional custom VM icons to the Unraid VM Manager.

Please install this from the Unraid community applications plugin.

I hope that people will submit custom icons to this repo which once approved will be added to the icons available to download for all.

Usage

After install Container should be set to auto start so icons are synced everytime the server or array starts.

Basic Unraid template settings

  1. Choose which custom icons you want to be installed from the drop downs. (Windows, Linux macOS, FreeBSD based (pfSense Freenas etc), and 'Other' Oses )

  2. Choose wether you want to keep the existing stock vm icons (recommended to keep) Setting this to no will remove the stock unraid vm icons from the vm manager.

  3. Set wether all icons are redownloaded when container starts. Setting this as yes will clear all vm icons then redownload all choosen icons from github repo. Setting to yes will on every start download any new icons in selected sections. (This is also useful if you deceide you no longer want a choosen section of icons anymore) The default is set to 'no'

  4. If your server has a beep speaker you can enable a tune to be played each time icons are synced. Yeah silly but fun! :)

Advanced settings (under show more settings)

  1. You can set how long the container should wait before exiting after syncing icons (default 30 seconds) Useful only to keep container running for longer if you need to bash into the container for debugging.

Other options dont change

Install vm_custom_icons on Unraid in a few clicks.

Find vm_custom_icons in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for vm_custom_icons Review the template variables and paths Click Install

Download Statistics

2,154,048
Total Downloads
28,140
This Month
12,164
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Explore more like this

Explore all

Details

Repository
spaceinvaderone/vm_custom_icons
Last Updated2025-07-31
First Seen2020-11-16

Runtime arguments

Web UI
http://[IP]:[PORT:3133]
Network
bridge
Shell
sh
Privileged
false

Template configuration

WebUI portPorttcp

WebUI port for the container

Target
3133
Default
3133
Value
3133
Container appdata path.Pathrw
Target
/config
Default
/mnt/user/appdata/vm_custom_icons
Value
/mnt/user/appdata/vm_custom_icons
SUCESS_TUNEVariable

Enable a notification tune when icons are loaded into the VM manager. (For this feature to work, your server must have a beep speaker attached. These are very cheap if you want one and available for a couple of $ each)

Default
no|yes
Value
no
UNRAID_IPVariable

Unraid IP address (not currently used) will be used in future updates along with the Unraid API.

Unraid VM icons pathPathrw

Path on the Unraid server to where the VM icons are stored. Do not change this path.

Target
/unraid_vm_icons
Default
/usr/local/emhttp/plugins/dynamix.vm.manager/templates/images
Value
/usr/local/emhttp/plugins/dynamix.vm.manager/templates/images
beep speakerDevice

Used if you have a beep speaker in your server and you want to have an audible notification when new icons are loaded.

Target
/dev/tty0
Value
/dev/tty0
UNRAID_APIVariable

UNRAID API KEY - not currently used for future features.

VERSIONVariable

Docker container version, do not change this value.

Target
version
Default
2.0
Value
2.0