---
title: "Best Practices for Citrix Configuration with Remote Clients"
slug: "install-citrix-workspace-app-with-bundled-remote-dx"
updated: 2025-07-15T09:50:33Z
published: 2025-07-15T09:50:33Z
canonical: "support.controlup.com/install-citrix-workspace-app-with-bundled-remote-dx"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.controlup.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Best Practices for Citrix Configuration with Remote Clients

This article includes best practice options for deploying Remote Clients (formerly Remote DX) for Citrix environments, including:

- [Deploy Remote Clients with Citrix Global App Configuration](/v1/docs/install-citrix-workspace-app-with-bundled-remote-dx#deploy-remote-clients-with-citrix-global-app-configuration)
- [Install Citrix Workspace app already bundled with Remote Clients agent](/tim-reorg/docs/install-citrix-workspace-app-with-bundled-remote-dx#install-citrix-workspace-app-already-bundled-with-remote-clients-agent)
- [Add Remote Clients process path to the virtual channel allow list using a wildcard for agent versions](/tim-reorg/docs/install-citrix-workspace-app-with-bundled-remote-dx#add-remote-clients-process-path-to-the-virtual-channel-allow-list-using-a-wildcard-for-agent-versions)

## Deploy Remote Clients with Citrix Global App Configuration

This section outlines the procedure to configure the Citrix Workspace App and to deploy plugins automatically, to enable your organization to control how Citrix Workspace App is deployed and configured when users connect to your resources. To learn more, refer to the [Citrix documentation](https://docs.citrix.com/en-us/citrix-workspace/global-app-config-service).

### Prerequisite

- **Citrix Workspace App**. From our [Download Center]( https://www.controlup.com/download-center/).

### Deployment

1. From the Citrix Workspace configuration screen, select **App Configuration** for your environment.
2. Select **Citrix Workspace App** and find the **ControlUp Remote DX plug-in**.
3. Select the **Windows** checkbox to enable the policy to distribute the Windows version. ![Citrix Workspace configuration screen with Citrix Workspace App and ControlUp Remote DX plug-in selected and Windows policy option enabled](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/CitrixWrkspcApp.png)
4. Optionally, you can click **Edit** to select the **Update type** and **Deployment mode** required for your organization.
5. Click **Save Draft** and publish your policy.

After the end-user connects to your Citrix environment, they will download the Workspace App configuration and install the **Remote DX Plugins Installer** service. The **Remote DX Plugins Installer** will install the **ControlUp Remote DX - Citrix** plugin and keep it up to date. After the **ControlUp Remote DX - Citrix plugin** installs on the machine, it will provide your organization visibility into the machine’s local network performance and CPU utilization.

## Install Citrix Workspace app already bundled with Remote Clients agent

This section outlines the procedure to install and configure a self-extracting Citrix Workspace App with an integrated bundle for Remote Clients.

### Prerequisites

- **7-Zip**. Download the installer according for your platform: [https://www.7-zip.org/download.html](https://www.7-zip.org/download.html)
- **7-Zip Extra**. Direct download link: [http://downloads.sourceforge.net/sevenzip/7z920_extra.7z](http://downloads.sourceforge.net/sevenzip/7z920_extra.7z)
- **Citrix Workspace App**. Download link: [https://www.citrix.com/downloads/workspace-app/windows/workspace-app-for-windows-latest.html](https://www.citrix.com/downloads/workspace-app/windows/workspace-app-for-windows-latest.html)
- **Remote Clients**. Download the Citrix Receiver version from our Download Center: [https://downloads.controlup.com/RemoteDX/citrix/windows/curdx_windows_citrix.exe](https://downloads.controlup.com/RemoteDX/citrix/windows/curdx_windows_citrix.exe)

### Installation

1. Run and extract the 7-Zip installer. By default, 7-Zip is installed in the *C:\Program Files\7-Zip* directory.
2. Extract the 7z920_extra.7z to the folder where you installed 7-Zip.
3. Copy the *CitrixWorkspaceApp.exe* and *curdx_windows_citrix.exe* to a folder. Select both files, right-click > **7-Zip** > **Add to archive**.
4. In the Add to Archive wizard, specify a new name for the archive. Click **OK** to start the compression of both files.
5. Once the file is created, locate the *7zS.sfx* in the 7-Zip installation folder.
6. Copy the *7zS.fsx* into the folder where you created the new archive. Both files must be located in the same directory: ![7zS.sfx and the 7zip archive both present in the same directory.](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/RemoteDX_Bundle_Step6.png)
7. In the same folder, create a *config.txt* file and insert the following script:

```plaintext
;!@Install@!UTF-8!
Title="Citrix Workspace App"
RunProgram="install.cmd"
;!@InstallEnd@!
```

1. In the same folder, create a new file *install.cmd* and insert the following text:

```plaintext
pushd %~dp0
CitrixWorkspaceApp.exe /silent
curdx_windows_citrix.exe /VERYSILENT
```

1. Drag and drop the *install.cmd* into the new archive and confirm the warning with **Yes**.
2. Open a command prompt and navigate to the path where the files are located.
3. In the command prompt, run the following command.

```plaintext
copy /b 7zS.sfx + config.txt + "CitrixAndRemoteDXinstaller.7z" archive.exe
```

**Note** Replace the name of the .7z file according to the file name you created.

This command creates a new self-extracting file (archive.exe) that includes the 7Zs.sfx, config.txt and the archived 7zip file:

1. Install the bundle and confirm that the installation was successful by pressing CTRL + R. Type **appwiz.cpl** and check if the Citrix Workspace App and Remote Clients appear.

## Add Remote Clients process path to the virtual channel allow list using a wildcard for agent versions

With the introduction of Citrix Virtual Apps and Desktops (CVAD) release 2109, third-party virtual channels must be explicitly allowed. A policy that controls the allow list was automatically enabled with CVAD 2109. To learn more, refer to the official [Citrix blog article](https://www.citrix.com/blogs/2021/10/14/virtual-channel-allow-list-now-enabled-by-default/).

### Use a wildcard in the path name for ControlUp agent versions

With CVAD release 2206, you can set wildcards in the path of processes that are added to the virtual channel allow list policy. The process path that runs the ControlUp agent enabling Remote Clients monitoring includes the version number for the agent. By enabling wildcards, the version does not have to be updated and the path can be entered to the virtual channel allow list policy just the one time.

To add the Remote Clients process path to the virtual channel for allow list, refer to the [Citrix documentation](https://docs.citrix.com/en-us/citrix-virtual-apps-desktops/secure/virtual-channel-security.html#adding-virtual-channels-to-the-allow-list), and use the following parameters:

- Virtual channel name: CUEPUX
- Process: C:\Program Files\Smart-X\ControlUpAgent\*\cuAgentHelper.exe
- Allow list entry: CUEPUX,C:\Program Files\Smart-X\ControlUpAgent\*\cuAgentHelper.exe

Disable virtual channel allow list

If you don't want to add the virtual channel, you can follow the workaround by disabling the virtual channel allow list policy in CVAD 2109 and higher. Once disabled, restart the VDA to apply the Virtual channel allow list policy.