Install, Uninstall, and Upgrade

You can install the Citrix Workspace app using any of the following methods:

  • Download the Citrix Workspace app from Citrix Downloads.
  • Deploy Citrix Workspace app using workspace for web (configured with StoreFront).

Manual install

Download the following packages from the Citrix Downloads page.

Debian packages

Install one of the Icaclient packages, or one of the IcaclientWeb packages based on your OS architecture.

To use generic USB redirection, install one of the ctxusb packages based on your OS architecture.

Package name Contents
Debian packages (Ubuntu, Debian, Linux Mint etc.)  
icaclient_20.06.0.15_amd64.deb Self-service support, 64-bit x86_64
icaclient_20.06.0.15_i386.deb Self-service support, 32-bit x86
icaclient_20.06.0.15_armhf.deb Self-service support, ARM HF
icaclientWeb_20.06.0.15_amd64.deb Web Receiver only, 64-bit x86_64
icaclientWeb_20.06.0.15_i386.deb Web Receiver only, 32-bit x86
icaclientWeb_20.06.0.15_armhf.deb Web Receiver only, ARM HF
ctxusb_20.06.0.15_amd64.deb USB package, 64-bit x86_64
ctxusb_20.06.0.15_i386.deb USB package, 32-bit x86
ctxusb_20.06.0.15_armhf.deb USB package, ARM HF

Install using a Debian package

If you are installing Citrix Workspace app from Debian package on Ubuntu, open the packages in the Ubuntu Software Center.

In the following instructions, replace packagename with the name of the package that you are trying to install.

This procedure uses a command line and the native package manager for Ubuntu/Debian/Mint. You can also install the package by double-clicking the downloaded .deb package in a file browser. This typically starts a package manager that downloads any missing required software. If no package manager is available, Citrix recommends you to use the gdebi, a command-line tool.

Prerequisites:

You must install the icaclient package or the icaclientWeb package.

To install the package using the command line:

  1. Log on as a privileged (root) user.
  2. Open a terminal window.
  3. Run the installation for the following three packages by typing gdebi packagename.deb. For example:

    • gdebi icaclient\_19.0.6.6\_amd64.deb
    • gdebi icaclientWeb\_19.0.6.6\_i386.deb
    • gdebi ctxusb\_2.7.6\_amd64.deb

    To use dpkg in the above examples, replace gdebi with dpkg -i.

    If using dpkg, install any missing dependencies by typing sudo apt-get -f install.

    Note:

    The ctxusb package is optional to support the generic USB redirection feature.

  4. Accept the EULA.

Red Hat packages

Install one of the ICAClient packages, or one of the ICAClientWeb packages based on your OS architecture.

To use generic USB redirection, install one of the ctxusb packages based on your OS architecture.

Package name Contents
Redhat packages (Redhat, SUSE, Fedora etc.)  
ICAClient-rhel-20.06.0.15-0.x86_64.rpm Self-service support, Red Hat (including Linux VDA) based, 64-bit x86_64
ICAClient-rhel-20.06.0.15-0.i386.rpm Self-service support, Red Hat based, 32-bit x86
ICAClientWeb-rhel-20.06.0.15-0.x86_64.rpm Web Receiver only, Red Hat based, 64-bit x86_64
ICAClientWeb-rhel-20.06.0.15-0.i386.rpm Web Receiver only, Red Hat based, 32-bit x86
ICAClient-suse-20.06.0.15-0.x86_64.rpm Self-service support, SUSE based, 64-bit x86_64
ICAClient-suse-20.06.0.15-0.i386.rpm Self-service support, SUSE based, 32-bit x86
ICAClientWeb-suse-20.06.0.15-0.x86_64.rpm Web Receiver only, SUSE based, 64-bit x86_64
ICAClientWeb-suse-20.06.0.15-0.i386.rpm Web Receiver only, SUSE based, 32-bit x86
ctxusb-20.06.0.15-1.x86_64.rpm USB package, 64-bit x86_64
ctxusb-20.06.0.15-1.i386.rpm USB package, 32-bit x86

Note:

The SuSE 11 SP3 Full Package (Self-Service Support) RPM package is deprecated.

Install using an RPM package

If you are installing Citrix Workspace app from the RPM package on SUSE, use the YaST or Zypper utility. The RPM utility installs the .rpm package. An error occurs if the required dependencies are missing.

To set up the EPEL repository on Red Hat

Download the appropriate source RPM package from: https://fedoraproject.org/wiki/EPEL#Extra_Packages_for_Enterprise_Linux_.28EPEL.29.

For information on how to use it, see https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F

For example, on Red Hat Enterprise 7.x, you can install the EPEL repository by using following command:

`yum localinstall epel-release-latest-7.noarch.rpm`

Tip:

RPM Package Manager does not install any missing required software. To download and install the software, we recommend using zypper install <file name> at a command line on OpenSUSE or yum localinstall <filename> on Fedora/Red Hat.

To install from the RPM package

Prerequisites:

You must install the icaclient package or the icaclientWeb package.

  1. Set up the EPEL repository.
  2. Log on as a privileged (root) user.
  3. Run the installation for the following three packages by typing zypper in .

    Note:

    The ctxusb package is an optional package. Install the package to support Generic USB Redirection.

  4. Open a terminal window.

    For SUSE installations:

    • zypper in ICAClient-suse-19.12.0.19-0.x86_64.rpm

    • zypper in ICAClient-suse-19.12.0.19-0.i386.rpm

    • zypper in ctxusb-2.7.19-1.x86\_64.rpm

    For Red Hat installations:

    • yum localinstall ICAClient-rhel-19.12.0.19-0.i386.rpm

    • yum localinstall ICAClientWeb-rhel-19.12.0.19-0.i386.rpm

    • yum localinstall ctxusb-2.7.19-1.i386.rpm

  5. Accept the EULA.

To install a missing package

On a Red Hat based distribution (RHEL, CentOS, Fedora, and so on), if the following error message appears:

“… requires libwebkitgtk-1.0.so.0”

add an EPEL repository (details can be found at https://fedoraproject.org/wiki/EPEL).

Tarball packages

Install one of the following packages based on your OS architecture.

Package name Contents
Tarballs (Script install for any distribution)  
linuxx64-20.06.0.15.tar.gz 64-bit Intel
linuxx86-20.06.0.15.tar.gz 32-bit Intel
linuxarmhf-20.06.0.15.tar.gz ARM HF

The difference between packages that offer support for Web Workspace app and those packages that support self-service is that the latter packages include dependencies required for self-service in addition to those needed for the Web Workspace app. Dependencies for self-service are a superset of those required for Web Workspace app, but the files installed are identical.

  • If you require only workspace app for web, or your distribution does not have the necessary packages to support self-service, install only the workspace app for web package.
  • Otherwise, install Citrix Workspace app from the Debian package or the RPM package. These files are easier to use because they automatically install any required packages.
  • If you want to customize the installation location, install Citrix Workspace app from the tarball package.

Note:

  • Do not use two different installation methods on the same machine. If you do, you might see error messages and unwanted behavior.

Install using a tarball package

Note:

The tarball package does not perform dependency checks nor install dependencies. All system dependencies must be resolved separately.

  1. Open a terminal window.
  2. Extract the contents of the .tar.gz file into an empty directory. For example, type: tar xvfz packagename.tar.gz.
  3. Type ./setupwfc and then press Enter to run the setup program.
  4. Accept the default of 1 (to install Citrix Workspace app) and press Enter.
  5. Type the path and name of the required installation directory and then press Enter, or press Enter to install Citrix Workspace app in the default location.

    The default directory for privileged (root) user installations is /opt/Citrix/ICAClient.

    The default directory for non-privileged user installations is $HOME/ICAClient/platform. Platform is a system-generated identifier for the installed operating system, for example, $HOME/ICAClient/linuxx86 for the Linux/x86 platform).

    Note:

    If you specify a non-default location, set it in $ICAROOT in $HOME/.profile or $HOME/.bash\_profile.

  6. When prompted to proceed, type y and then press Enter.
  7. You can choose whether to integrate Citrix Workspace app into your desktop environment. The installation creates a menu option from which users can start Citrix Workspace app. Type y at the prompt to enable the integration.
  8. If you have previously installed GStreamer, you can choose whether to integrate GStreamer with Citrix Workspace app, and thus, support HDX Mediastream Multimedia Acceleration. To integrate Citrix Workspace app with GStreamer, type y at the prompt.

    Note:

    On some platforms, installing the client from a tarball package can cause the system to become unresponsive after prompting you to integrate with KDE and GNOME. This issue occurs with the first time initialization of gstreamer-0.10. If you encounter this issue, terminate the installation process (using the keys ctrl+c) and run the command gst-inspect-0.10 -- gst-disable-registry-fork --version. After running the command, you can rerun the tarball package without experiencing the issue.

  9. If you log on as a privileged user (root), choose to install USB support for Citrix Virtual Apps and Desktops published VDI applications. Type y at the prompt to install USB support.

    Note:

    If you are not logged on as a privileged user (root), the following warning appears:

    “USB support cannot be installed by non-root users. Run the installer as root to access this install option.”

  10. When the installation completes, the main installation menu appears again. To exit setup, type 3 and then press Enter.

Uninstall

This procedure has been tested with the tarball package. Remove the RPM and Debian packages using your operating system’s standard tools.

The environment variable ICAROOT must be set to the installation directory of the client. The default directory for non-privileged user installations is $HOME/ICAClient/platform. The platform variable is a system-generated identifier for the installed operating system, for example, $HOME/ICAClient/linuxx86 for the Linux/x86 platform. Privileged user installation defaults to /opt/Citrix/ICAClient.

Note:

To uninstall Citrix Workspace app, you must be logged in as the same user who performed the installation.

To uninstall the tarball package

  1. Run setup by typing $ICAROOT/setupwfc and press Enter.
  2. To remove the client, type 2 and press Enter.

Upgrade

To upgrade from Citrix Receiver to Citrix Workspace app, download and install the latest Citrix Workspace app from Citrix Downloads.

The Citrix Workspace screen overlay appears on the first launch of the app, when you upgrade, and when you uninstall and reinstall the app. Click Got it to continue using Citrix Workspace app, or click Learn more to find out more details.

Install, Uninstall, and Upgrade