Creating Custom Agent Icons

Four Agent Icons

To incorporate custom agent icons in the system tray (Windows) or menu bar (Mac OS X) of each managed machine, create four icons. These icons must be named:

For Windows Agents

  • online.ico – By default, this is the blue K icon displayed when agent is connected to the Kaseya Server.
  • offline.ico – By default, this is the gray K icon displayed when agent is not connected to the Kaseya Server.
  • blink.ico – By default, this is the white K icon displayed when agent requires the user to click the icon to see a message.
  • noremote.ico – By default, this is the red K icon displayed when the user has selected the Disable remote control menu item from the agent popup menu.

For Mac Agents

  • macOnline.tif - By default, this is the blue K icon displayed when agent is connected to the Kaseya Server.
  • macOffline.tif - By default, this is the gray K icon displayed when agent is not connected to the Kaseya Server.
  • macNoremote.tif - By default, this is the red K icon displayed when the user has selected the Disable remote control menu item from the agent popup menu.
  • macBlink.tif - By default, this is the white K icon displayed when agent requires the user to click the icon to display a message.

For Linux Agents

  • linuxOnline.png - By default, this is the blue K icon displayed when agent is connected to the Kaseya Server.
  • linuxOffline.png - By default, this is the gray K icon displayed when agent is not connected to the Kaseya Server.
  • linuxNoremote.png - By default, this is the red K icon displayed when the user has selected the Disable remote control menu item from the agent popup menu.
  • linuxBlink.png - By default, this is the white K icon displayed when agent requires the user to click the icon to display a message.

Formatting Custom Agent Icons

For Windows custom agent icons:

  • The format must use the Windows icon format. A simple bitmap file cannot simply be renamed using the .ico extension.
  • The maximum size of 32x32 pixels is recommended.
  • The color depth cannot exceed 8 bit color (256 colors).

For Apple custom agent icons:

  • The format must be .tif.
  • The maximum size of 48x48 pixels is recommended.
  • The color depth should be RGB 32 bit color.

For Linux custom agent icons:

  • The format must be .png.
  • A size of 24x24 pixels is recommended.
  • The color depth cannot exceed 8 bit color (256 colors).

Installing Custom Icons

  1. Navigate to the System > Site Customization > Agent Icons tab.
  2. Click the Agent Icons tab.
  3. Click the Edit button. The Edit Agent Icons dialog displays.
  4. Click the browse button for any agent icon to select a custom agent icon on your local machine.
  5. Optionally click the Use Default buttons to reset agent icons to their default images.

Updating Existing Agents with Custom Agent Icons

The customized agent icons are automatically deployed when updating Agents using the Agent tab > Manage Agents. You will need to check the Force update check box to update agents that are already at the current version.

Creating Agent Install Packages with Custom Agent Icons

Updated agent icons are included in any newly downloaded KcsSetup files created by Manage Package. If you have placed an agent installer KcsSetup file in a domain logon script, then you must re-download the KcsSetup file to include the updated icons and replace the file on the domain server.