How to Troubleshoot VDI plugin installation in Zoom App

This post was most recently updated on July 29th, 2022

Owners and administrators of the Linux plugins have the option to force activate the Smart Virtual Background (VB) feature.

A Smart VB application is capable of performing a face recognition to be able to create a mask for the background image of the participant behind which the mask will be generated.

The process for enabling Smart Virtual Backgrounds

The Smart VB feature can be overridden in the Smart VB feature using an override. If you want Smart VB to operate when VDI client is not on the list of allowed clients, you can do it by using the override. Depending on the results, you may observe different functionality. It is not advisable to use the ZoomMedia.ini override capability during testing since it enables editing the code of the ZoomMedia.ini file, which requires editing only the file itself.

If you are using a Mac or a Windows computer, you may need to change where ZoomMedia.ini files reside on your computer depending on the operating system you are using. The section below provides a list of where to find the ZoomMedia.ini file for your installation. If you have any questions concerning where you may find this file, please contact our Customer Service Team.

There are several ways in which ZoomMedia.ini can be edited.

The following changes must be made to ZoomMedia.ini in order for Smart Virtual Backgrounds to be activated; they must be saved.

  1. You need to open ZoomMedia.ini file.
  2. In the [FEATURE] section, you will find the section to be edited.
  3. Click on SMARTVB and it will appear in the list of entries.
  4. By default, SMARTVB is set to zero.
  5. This should be changed to SMARTVB=1.
  6. After the changes have been made, you will need to restart.

Versions 5.8.0 and above of the VDI Release are supposed to include some additional configuration files; here are some examples:

In version 5.8.0, ZoomMedia.ini file is moved to a new location. In the event that you have updated the ZoomMedia.ini file in the past and have now made changes that affect all platforms, path information for the plugins has been included below as well.

If you are using a version older than 5.8.0 of Zoom VDI Linux plugin, please refer to this Support article for additional instructions on configuring ZoomMedia.ini file if you do not know the path to the installation directory.

Locations of new files

Linux (Ubuntu)

AVD plugin for Citrix/VMware: /etc/zoomvdi/ZoomMedia.ini


In the case of Citrix/VMware, the plugin is located in /etc/zoomvdi/ZoomMedia.ini


AVD plugin for Citrix/VMware: /etc/zoomvdi/ZoomMedia.ini


AVD plugin for Citrix/VMware: /etc/zoomvdi/ZoomMedia.ini


Plugin for Citrix/VMware: /setup/elux/.config/ZoomMedia.ini

Additions to the requirements for Smart Virtual Backgrounds

Visit the Smart Virtual Backgrounds for Linux support article for more information about the requirements for the backgrounds.