Install, Uninstall, and Update
You can install the Citrix Workspace app using any of the following methods:
- Download the Citrix Workspace app from the Citrix Downloads page, configure using an email or services address with StoreFront.
- Deploy Citrix Workspace app for Linux using Citrix Workspace for Web (configured with StoreFront).
- Deploy Citrix Workspace app for Linux from Citrix Web Interface 5.4.
Download the following packages from the Citrix Downloads page.
Using Debian packages
|Debian packages (Ubuntu, Debian, Linux Mint etc.)|
|icaclient_184.108.40.206_amd64.deb||Self-service support, 64-bit x86_64|
|icaclient_220.127.116.11_i386.deb||Self-service support, 32-bit x86|
|icaclient_18.104.22.168_armhf.deb||Self-service support, ARM HF|
|icaclientWeb_22.214.171.124_amd64.deb||Web Receiver only, 64-bit x86_64|
|icaclientWeb_126.96.36.199_i386.deb||Web Receiver only, 32-bit x86|
|icaclientWeb_188.8.131.52_armhf.deb||Web Receiver only, ARM HF|
|ctxusb_2.7.15_amd64.deb||USB package, 64-bit x86_64|
|ctxusb_2.7.15_i386.deb||USB package, 32-bit x86|
|ctxusb_2.7.15_armhf.deb||USB package, ARM HF|
Install using a Debian package
If you are installing the Citrix Workspace app from the Debian package on Ubuntu, you might find it convenient to open the packages in the Ubuntu Software Center.
In the following instructions, replace packagename with the name of the package that you are installing.
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 gdebi, a command-line tool that performs this function.
To install the package using the command line:
- Log on as a privileged (root) user.
- Open a terminal window.
Run the installation for the following three packages by typing
gdebi packagename.deb. For example:
dpkgin the above examples, replace
You must install the icaclient package or the icaclientWeb package. The ctxusb package is optional to support the generic USB redirection feature.
- If using
dpkg, install any missing dependencies by typing sudo apt-get -f install.
- Accept the EULA.
Using Redhat packages
|Redhat packages (Redhat, SUSE, Fedora etc.)|
|ICAClient-rhel-184.108.40.206-0.x86_64.rpm||Self-service support, RedHat (including Linux VDA) based, 64-bit x86_64|
|ICAClient-rhel-220.127.116.11-0.i386.rpm||Self-service support, RedHat based, 32-bit x86|
|ICAClientWeb-rhel-18.104.22.168-0.x86_64.rpm||Web Receiver only, RedHat based, 64-bit x86_64|
|ICAClientWeb-rhel-22.214.171.124-0.i386.rpm||Web Receiver only, RedHat based, 32-bit x86|
|ICAClient-suse-126.96.36.199-0.x86_64.rpm||Self-service support, SUSE based, 64-bit x86_64|
|ICAClient-suse-188.8.131.52-0.i386.rpm||Self-service support, SUSE based, 32-bit x86|
|ICAClientWeb-suse-184.108.40.206-0.x86_64.rpm||Web Receiver only, SUSE based, 64-bit x86_64|
|ICAClientWeb-suse-220.127.116.11-0.i386.rpm||Web Receiver only, SUSE based, 32-bit x86|
|ctxusb-2.7.15-1.x86_64.rpm||USB package, 64-bit x86_64|
|ctxusb-2.7.15-1.i386.rpm||USB package, 32-bit x86|
Following the 1908 release of Citrix Workspace app for Linux the SuSE 11 SP3 Full Package (Self-Service Support) RPM package will be deprecated. It will no longer be available from the Citrix Downloads page page.
Install using an RPM package
If you are installing Citrix Workspace app from the RPM package on SUSE, use the YaST or Zypper utility, not the RPM utility. The RPM utility does not download or install any necessary dependencies, it only installs the .rpm package. If the required dependencies are missing, you will receive an error.
To follow an example of an installation using a RPM package, see the Citrix Blog article Installing Citrix Receiver for Linux 13.2.1 on SUSE Linux Enterprise Desktop.
In the following instructions, replace <packagename> with the name of the package that you are installing.
If you receive an error indicating that the installation “… requires libwebkitgtk-1.0.so.0” on Red Hat based distributions (RHEL, CentOS, Fedora, etc.), add the EPEL repository (details can be found at https://fedoraproject.org/wiki/EPEL), which can provide the missing package, or switch to the Web variant of the package.
To set up the EPEL repository on Red Hat:
Download the appropriate source RPM package from here:
For example, for Red Hat Enterprise 7.x:
yum localinstall epel-release-latest-7 .noarch.rpm
RPM Package Manager does not install any missing required software. To download and install the software, Citrix recommends using zypper install <file name> at a command line on OpenSUSE or yum localinstall <filename> on Fedora/Red Hat.
After setting up the EPEL repository, install Workspace app from the RPM package:
Log on as a privileged (root) user.
Run the installation for the following three packages by typing zypper in packagename.rpm.
A user must install the icaclient package or the icaclientWeb package. The ctxusb package is an optional to support Generic USB Redirection.
Open a terminal window.
For SUSE installations:
zypper in ICAClient-suse-18.104.22.168-0.x86_64.rpm
zypper in ICAClient-suse-22.214.171.124-0.i386.rpm
zypper in ctxusb-2.7.6-1.x86_64.rpm
For Red Hat installations:
yum localinstall ICAClient-rhel-126.96.36.199-0.i386.rpm
yum localinstall ICAClientWeb-rhel-188.8.131.52-0.i386.rpm
yum localinstall ctxusb-2.7.6-1.i386.rpm
Accept the EULA.
Using Tarball packages
|Tarballs (Script install for any distribution)|
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 Web Workspace app support, or your distribution does not have the necessary packages to support self-service, install the Web Workspace app only package.
If your distribution allows, install Citrix Workspace app from the Debian package or from the RPM package. These files are easier to use because they automatically install any required packages.
If you want to control the installation location, install Citrix Workspace app from the tarball package.
Do not use both installation methods on the same machine. If you do, for example, if you install Citrix Workspace app for Linux from a tarball package on a machine where Citrix Workspace app for Linux was already installed from a Debian package, you are likely to see error messages and unwanted behaviors.
Install using a tarball package
The tarball package does not perform dependency checking or installation of dependencies. All system dependencies must be resolved separately.
- Open a terminal window.
- Decompress the .tar.gz file and extract the contents into an empty directory. For example, type: tar xvfz packagename.tar.gz.
- Type ./setupwfc and then press Enter to run the setup program.
- Accept the default of 1 (to install the Workspace app) and press Enter.
Type the path and name of the required installation directory and then press Enter, or press Enter to install 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).
If you specify a non-default location, set it in $ICAROOT in $HOME/.profile or $HOME/.bash_profile.
When prompted to proceed, type y and then press Enter.
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.
If you have previously installed GStreamer, you can choose whether to integrate GStreamer with Citrix Workspace app and so support HDX Mediastream Multimedia Acceleration. To integrate Citrix Workspace app with GStreamer, type y at the prompt.
On some platforms, installing the client from a tarball distribution may cause the system to hang 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 ctrl+c) and run the command gst-inspect-0.10 – gst-disable-registry-fork –version. After executing this command, you can rerun the tarball setup without experiencing a system hang.
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.
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.”
- When the installation is complete, the main installation menu appears again. To exit from the setup program, type 3 and then press Enter.
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.
- Run the setup program by typing
$ICAROOT/setupwfcand press Enter.
- To remove the client, type 2 and press Enter.
To uninstall Citrix Workspace app for Linux, you must be logged in as the same user who performed the installation.
Download the Citrix Workspace app from the Citrix Downloads page and install the app to upgrade from Citrix Receiver to Citrix Workspace app.
Citrix Workspace app has a new icon set in a blue theme. It replaces the earlier Citrix Receiver icon that had a black theme.
The Citrix Workspace screen overlay appears on the first launch of the app or when you upgrade and when you uninstall and reinstall the app, to inform you about the transition. You can either click Got it to continue using the Workspace app, or click Learn more to find out more details.