Citrix Client Overview for Virtual Office CS and SaaS

Alerts and notices

In relation to the Virtual Office CS and SaaS (Software as a Service) environments, Citrix is a third-party application that allows remote desktop connections. Citrix must be installed on any computer on which you will run applications in the Virtual Office CS or SaaS environment.

Your firm may also implement Citrix if you host a terminal services/remote desktop environment. In this scenario, we recommend that your firm relies on a qualified and certified terminal server professional to handle the installation of CS Professional Suite applications in a terminal server environment. For more information, see Terminal server best practices for CS Professional Suite.

Downloading Citrix Receiver

To download and install the Citrix Receiver application:

  1. In the NetStaff CS tab of the navigation pane located in on the left side of the webpage, click the Applications link.

    Note: If you don’t see this link, you don’t have access to applications through Virtual Office CS or SaaS. See, Assigning applications and modules to NetStaff users.

  2. Click the Setup button in the upper-right of the webpage and select Citrix in the drop-down.
  3. The steps required to install Citrix Receiver vary by browser. Click the name of your browser to view the remaining steps.
    1. Click the VOCitrixWeb.exe button in the bottom left corner of the window.
    2. On the Open File - Security Warning dialog, click Run (if you instead see a User Account Control dialog, click Yes).
    3. On the Setup - VO Citrix dialog, click Install.
    4. When the installation is complete, click Finish.

      Note: If you experience any issues installing or running VOCitrixWeb.exe, try running the installation as administrator, or disable the user account control (UAC) setting.

    1. On the Opening VOCitrixWeb.exe dialog, click Save File.
    2. On the Downloads dialog, double-click VOCitrixWeb.exe.

      Note: If you are prompted with an Open Executable File? dialog, click OK.

    3. On the Open File - Security Warning dialog, click Run.
    4. When the installation is complete, click OK.

      Note: If you experience any issues installing or running VOCitrixWeb.exe, try running the installation as administrator, or disable the user account control (UAC) setting.

    1. On the File Download - Security Warning dialog, click Save.

      Note: If you are prompted with an Internet Explorer Security Warning dialog, click Run.

    2. When the installation is complete, click OK.

      Note: If you experience any issues installing or running VOCitrixWeb.exe, try running the installation as administrator, or disable the user account control (UAC) setting.

Best practices

Listed are the recommended best practices when running Citrix with the CS Professional Suite.

Because Virtual Office CS and SaaS are accessed via the Internet and information travels through an Internet connection, the performance of the software is subject to the same speed variations experienced using the web. For this reason, the bandwidth used when accessing the Internet has a significant impact on the performance of the software.

At a minimum, 128 Kbps for up to four users and 32 Kbps for each additional user should be dedicated to running the Citrix client. To achieve optimal product performance, we recommend at least 64 Kbps per user. Examples of Internet connections that meet these recommendations include dual-channel ISDN, cable modem, ADSL or DSL, T1, and T3.


  • Wireless Internet connections are not supported and not recommended for Citrix connections due to the instability of the wireless signal. Performance on wireless networks cannot be guaranteed.
  • We do not recommend running Virtual Office CS or SaaS over satellite or microwave Internet connections.
  • The above bandwidth recommendations are solely for running Citrix for Virtual Office CS and SaaS. Keep in mind that your firm will require additional bandwidth for other business needs.

For the Citrix Client to function properly, the .ica file type must be excluded from antivirus scanning. It is also important that the .ica file extension is associated with the Citrix application in your Windows operating environment. To learn how to associate a file type with a program in Windows, see the Microsoft article Change which programs Windows uses by default External link .

Additionally, make sure that appropriate permissions are set to the following folders:

  • C:\Program Files\Citrix\ICA Client
  • C:\Program Files\Citrix\Receiver
  • C:\Program Files\VO Citrix
  • C:\Users\[username]\AppData\Roaming\ICA Client
  • C:\Users\[username]\AppData\Local\Citrix

For additional information on permissions, see Permissions Guidelines for CS Professional Suite.

Because Citrix will occasionally need to communicate with local files and possibly with external storage devices, appropriate session security should be set.  You will most likely be prompted automatically to grant security access the first time you launch Citrix. However, if you need to set up access manually, you can use the Citrix Connection Center.

  1. In your computer's Windows system tray, look for the black and white Citrix Receiver icon (you may have to click the Show hidden icons arrow).
  2. Right-click the Citrix icon and choose About or Advanced Preferences.

If you see About:

  1. Choose About.
  2. On the About Citrix Receiver dialog, click Advanced to expand that menu.
  3. Click the Connection Center link.
  4. On the Citrix Connection Center dialog, click the name of the server to which you are connected to access the items on the right-hand side under Session Security.
  5. Under the drop-down menus for Files and USB/Other Devices, select Full Access and then click Close to save the changes.
  6. Click OK to close the About Citrix Receiver dialog.

If you see Advanced Preferences:

  1. Choose Advanced Preferences.
  2. On the Advanced Preferences dialog, click the Connection Center link.
  3. On the Citrix Connection Center dialog, click the name of the server to which you are connected and click Preferences.
  4. On the Connections tab, choose the option to either Connect automatically or Ask me for Microphones and webcams and Digital cameras and scanners.
  5. Click OK.

For information on configuring your antivirus and firewall, see the appropriate Virtual Office CS sections in Antivirus Guidelines for CS Professional Suite and Firewall Guidelines for CS Professional Suite.

There are a few known firewall configuration issues that affect performance on Virtual Office CS:

  • F5  Nagel Algorithm settings
  • SonicWall – Deep Packet Inspection settings and or Flexible Packet Inspection Settings

Settings for other hardware and software firewalls may cause similar effects. These should be addressed by a qualified IT professional or product support technicians for the firewall in use.

During the initial launch of the Citrix client, Citrix searches for and connects to all printers connected to the workstation. The process of auto-creating and mapping printers on Virtual Office CS servers can be resource intensive.  The number of printers installed on your local workstation has a direct impact on the amount of time required to log in to the Virtual Office CS server. Deleting any unused or test printers will help maintain server responsiveness and improve login times.

To view the printers and devices that are connected to your computer in Windows and learn how to manage them, see the Microsoft article Install, view, and manage your devices and printers External link .

You are able to scan into multiple Virtual Office CS applications using TWAIN redirection built in to the Citrix client. As long you are using a Citrix-compatible scanner with a TWAIN or WIA driver installed, Citrix should be able to recognize and use your connected device. See Scanning Expectations / Recommendations for Virtual Office CS for more information.

Note: For assistance installing, configuring or troubleshooting your device and the appropriate print or scan drivers for it, consult your qualified IT professional or the hardware manufacturer.

If you are receiving prompts to update your Citrix Receiver you will want to turn off these notifications to stay on the supported version of Citrix Receiver.

  1. From the Windows System Tray, right-click on Citrix Receiver
  2. Choose Advanced Preferences and then select Receiver Updates.

    If you do not see the Update option you do not need to turn off Receiver updates

  3. Change this option to No, don't notify me and choose Save.


Below are a few examples of issues that have been observed with Citrix, along with common troubleshooting processes. Click the links below for detailed information on each issue.

Resetting the Citrix Receiver

There have been some situations like apps not opening, Citrix errors, etc. that the reset Citrix Receiver option has worked without having to uninstall / reinstall Citrix.

To reset your Citrix Receiver.

  1. Open the Windows System Tray by pressing the Windows key + B, then press Enter.
  2. Right-click on the Citrix Receiver icon and choose Advanced Preferences.
  3. Select Reset Receiver and follow the prompts to reset your Citrix receiver
  4. When asked to Add an account, choose Close.


Note: For any additional assistance with Citrix, consult your qualified IT professional and visit Citrix Support. External link

Related topic

Citrix Receiver and Upgrading to Windows 10

Library of Systems Content for CS Professional Suite