top of page
  • Writer's pictureIGEL Community

Citrix Microsoft Teams Optimization

Written by: Florian Klickermann, Linux Developer

This guide is a summary of the key points of the Citrix Optimization for Microsoft Teams Guide.

I ask you to extend the troubleshooting at the end of the guide and tell me your opinion about the comments. 

Enable optimization of Microsoft Teams

The Microsoft Team Optimization can be activated in the setup on the page:

Sessions > Citrix > Citrix Global > Unified Communications > VDI Solutions > Microsoft Teams optimization

or in the registry under:

ica.module.virtualdriver.vdwebrtc.enable Microsoft Team Optimization is activated by default in IGEL OS and no further settings are necessary.

To enable optimization for Microsoft Teams, use the Studio policy described in Microsoft Teams redirection policy (it is ON by default).


Open MS Teams in the Citrix Session. If you click About > Version, the Citrix HDX Optimized legend displays:

Optimized Microsoft Teams

If you see Citrix HDX Not Connected instead, the Citrix API is loaded in Teams (which is the first step towards redirection), but there was an error in the subsequent parts of the stack. The error is most likely in the VDA services or the Citrix Workspace app)

No connection

If you don’t see any legend, Teams failed to load the Citrix API. Exit Teams by right-clicking on the notification area icon and restart. Make sure the Studio policy is not set to Prohibited, and that the Citrix Workspace app version is supported.


When optimization for Microsoft Teams is active, the Citrix Workspace app accesses the peripherals (headset, microphone, cameras, speakers, and so forth). Then the peripherals are properly enumerated in the Microsoft Teams UI (Settings > Devices). If the optimization works, the process HDXTeams (2006) / HdxRtcEngine (2009) is started on the client. 

System Requirements

Supported operating systems:

Delivery Controller: ​​​​​​​

  • Windows Server 2019, 2016, 2012R2 Standard and Datacenter Editions, and with the Server Core option

Virtual Delivery Agents:

  • Windows 10 64-bit, versions 1607 and higher.

  • Windows Server 2019, 2016, and 2012 R2 (Standard and Datacenter Editions).

Microsoft Teams Installation

Citrix recommends you follow the Microsoft Teams machine-wide installation guidelines and avoid using the .exe installer that installs Teams in AppData. Instead, install in C:\Program Files (x86)\Microsoft\Teams by using the ALLUSER=1 flag from the command line.

msiexec /i <path_to_msi> /l*v <install_logfile_name> ALLUSER=1 ALLUSERS=1

The Microsoft Teams installation may be a 64Bit version, we have not tested a 32Bit installation. 


bottom of page