Citrix Workspace Cleanup

Posted on  by admin
downloadWhy can't I download this file?Citrix Workspace Cleanup
  • Citrix Workspace Cleanup Tool
  • Cleanup

    Right click on Citrix Receiver and select Advanced Preferences. In the About section, look for the Citrix Receiver version. If it is version (or for some users, you can contact support to verify what version you should be on) follow the steps to Reset Citrix Receiver. Download the Clean Up Utility by using the button above. Uninstall Citrix Receiver or the Citrix Workspace application using the default uninstall procedure: Go to Start Control Panel Programs and Features Select the Citrix Receiver or Workspace app and click uninstall. Now run the Citrix Clean Up Utility. /forceinstall - This switch is effective when cleaning up any existing configuration or entries of Citrix Workspace app in the system. Use this switch in the following scenarios: Upgrading from an unsupported version of Citrix Workspace app version. The installation or upgrade is unsuccessful.

    Applicable Products

    • Citrix Workspace App
    • Receiver for Windows


    This article is intended for Citrix administrators and technical teams only.
    Non-admin users must contact their company’s Help Desk/IT support team and can refer to CTX297149 for more information.
    Citrix Workspace app is the new universal app for all workspace services, that will encompass all Citrix clients and app capabilities over time.


    Under certain circumstances, uninstalling older versions of Receiver for Windows may leave some files behind on the computer and in the registry.This article can also be used as reference to completely clean a system after uninstalling a legacy ICA Client or Citrix Online Plug-in version.
    Note: If you plan to install a currently supported version of Receiver for Windows on the system (version 4.4 or later) then there is no need to perform these manual steps or run the clean-up utility. As per article CTX136410, Receiver for Windows 4.4 and later no longer require the separate Clean-Up Utility before installing or upgrading over a previously installed version of Receiver for Windows.


    Citrix Workspace Cleanup

    Run the following tool: CTX137494 - Receiver Clean-Up UtilityCitrix

    After uninstalling Receiver and restarting the system, the following steps guide to remove any unnecessary files manually that might have been left on the client system.

    It is important to remember that certain items mentioned in the following section might not exist on your system depending on the Receiver package used for the installation and how the package was deployed, for example per-machine against per-user installation.
    More information on this is available in the Receiver and Plug-ins section of the Citrix eDocs for your version.

    Following are the steps for cleaning up the file system:

    1. On the system in use, show all hidden system files and folders (Explorer’s Tools > Folder Options menu item).

    2. In the %userprofile%AppData folder

      • Delete the ICAClient folder if it exists.

      • If the Program Neighborhood Agent was present on the system, the following folder might also exist and should be deleted:

      • For more recent Citrix Receiver releases, remove the following folders in AppData if they exist:

        • CitrixReceiver
        • CitrixAuthManager
        • CitrixSelfService
      • On Windows 7, the files and folders mentioned in the preceding must be deleted in both of the following locations:

        • AppDataLocal
        • AppDataRoaming
    3. Repeat everything mentioned in preceding Step 2 for the C:UsersDefault folder as well (C:Documents and SettingsDefault User on Windows XP).

    4. If they exist, ensure the following folders are removed from the directory in which the Receiver was installed. For example, the default install directory is %programfiles%Citrix (%programfiles(x86)%Citrix on 64-bit systems).

      • %programfiles%CitrixICA Client
      • %programfiles%CitrixAuthManager
      • %programfiles%CitrixSelfServicePlugin

    Complete the following steps to clean up the system registry:
    Caution! Refer to the Disclaimer at the end of this article before using Registry Editor.

    1. Using Registry Editor, navigate to the HKEY_CLASSES_ROOT key and delete the following keys if they exist:

      • Citrix.ICAClient* (delete all instances that exist – such as Citrix.ICAClient.2 or Citrix.ICAClient.2.1)
      • Citrix.ICAClientProp* (delete all instances – such as Citrix.ICAClientProp.2 or Citrix.ICAClientProp.2.1 might exist)
      • ica
      • In the CLSID key, delete any keys whose names begin with 238F
      • InstallerUpgradeCodes9B123F490B54521479D0EDD389BCACC1
      • MimeDatabaseContent Typeapplication/x-ica
      • Wfica
      • WinFrameICA
      • ICA Client
    2. Navigate to HKEY_CURRENT_USER and delete the following in SOFTWARECitrix if they exist:
      • ICA Client
      • PNAgent
      • Dazzle
      • PrinterProperties
      • Receiver
      • XenDesktopDesktopViewer
    3. Navigate to HKEY_LOCAL_MACHINESOFTWARE and delete the following keys if they exist (these keys are located in HKEY_LOCAL_MACHINESOFTWAREWow6432Node on 64-bit systems):

      • CitrixAuthManager
      • CitrixCitrixCAB
      • CitrixDazzle
      • CitrixICA Client
      • CitrixReceiverInside
      • CitrixPNAgent
      • CitrixPluginPackagesXenAppSuite
      • CitrixXenDesktopDesktopViewer
      • In CitrixInstall, delete the following keys if they exist:
        • {94F321B9-45B0-4125-970D-DE3D98CBCA1C}
        • ICA Client
        • PNAgent
        • DesktopViewer
        • ReceiverInsideForOnline
        • MUI
      • Depending on the Receiver package installed, delete one of the following keys in MicrosoftWindowsCurrentVersionUninstall if they exist:
        • CitrixOnlinePluginFull
        • CitrixOnlinePluginPackWeb
    4. After uninstalling the Receiver software, any custom Receiver-side registry keys that icaclient.adm created remain in the registry as well. If you reinstall Receiver, these policies might be enforced possibly causing unexpected behavior. If you want to remove these customizations as well, delete the following ICA Client keys:

      • HKEY_LOCAL_MACHINESoftwarePoliciesCitrixICA Client
      • HKEY_CURRENT_USERSoftwarePoliciesCitrixICA Client
      • On 64-bit systems, ensure that the HKEY_LOCAL_MACHINESoftwareWow6432NodePoliciesCitrixICA Client key does not exist either.
    5. For each user’s registry hive in HKEY_USERS, delete the following keys in SOFTWARECitrix if they exist (example HKEY_USERSS-1-5-18SoftwareCitrix):

      • ICA Client
      • Dazzle
      • Receiver
      • PrinterProperties
      • PNAgent
      • Program Neighborhood Agent
    6. Repeat everything in Step 5 in the key: HKEY_USERS.DEFAULTSoftwareCitrix

    Additional Resources

    Citrix recommends you to restart the system after editing the registry.

    The number of items, their locations and names mentioned in this article might change in subsequent releases of the Receiver for Windows.

    CTX121917 - How to Remove Legacy ICA Clients for Windows Using MSI or EXE Command-line Parameters

    Refer Receiver and Plug-ins section of the Citrix eDocs.


    Citrix Workspace Cleanup Tool

    Caution! Using Registry Editor incorrectly can cause serious problems that might require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Be sure to back up the registry before you edit it.