- Citrix Workspace app for Linux
- Language support
- Deprecation
- Earlier versions
- Legacy documentation
- Install, Uninstall, and Update
- Verify the version of the Citrix Workspace app
- Manual install
- Debian packages
- Install using a Debian package
- Silent installation of the app protection component on Debian packages
- Red Hat packages
- Install using an RPM package
- To install from the RPM package
- To install a missing package
- Tarball packages
- Install using a tarball package
- Uninstall
- To uninstall Citrix Workspace app on the tarball package
- To uninstall Citrix Workspace app on Debian/Ubuntu Operating systems
- 2 Ways to Install Citrix Receiver and Connect to Desktops from Ubuntu and Other Linux
- 4 min
- Method 1: Install Citrix Receiver in Linux and Connect to Desktops
- Install Citrix Workspace App for Fedora, Red Hat, and Other .rpm-based distributions
- Install Citrix Workspace App for Ubuntu, Linux Mint, and Other Debian-based distributions
- How to Use Citrix Workspace App
- Method 2: Install and Connect to Citrix Desktop via Google Chrome Extension
- How to use Citrix Workspace Chrome Extension
- Troubleshooting and FAQ for Citrix Receiver in Linux
- 1. ALT+TAB via keyboard doesn’t detect the windows inside Citrix
- 2. Trusted certificate error
- Wrapping Up
Citrix Workspace app for Linux
Citrix Workspace app for Linux is a software client that lets you access your desktops, applications, and data easily and securely from many types of Linux devices. Citrix Workspace app provides access from your desktop, Citrix Workspace user interface, or web browsers.
Working with a Citrix-enabled IT infrastructure, Citrix Workspace app gives you the mobility, convenience, and freedom you need to get your work done.
You can use Citrix Workspace app on PCs, tablets, and thin clients. By using Citrix StoreFront with Citrix Workspace app, your organization can provide self-service access to applications and desktops. And that access comes with a common user interface, regardless of the endpoint device hardware, operating system, or form factor.
For information about the features available in Citrix Workspace app for Windows, see Citrix Workspace app feature matrix.
Language support
Citrix Workspace app for Linux is adapted for use in languages other than English. For a list of languages supported by Citrix Workspace app for Linux, see Language support.
Deprecation
The announcements in this article give you advanced notice of platforms, Citrix products, and features that are being phased out. Using these announcements, you can make timely business decisions.
Citrix monitors customer use and feedback to determine when they are withdrawn. Announcements can change in subsequent releases and might not include every deprecated feature or functionality.
Deprecated items aren’t removed immediately. Citrix continues to support them in this release but they will be removed in the future.
Item | Deprecation announced in | Removed in | Alternative |
---|---|---|---|
GTK2 | 2209 | — | — |
VDSCARD.DLL | 2209 | — | VDSCARDV2.DLL |
Gstreamer 0.1 | 2205 | — | — |
Web Packages | 2010 | 2101 | Full Packages |
SUSE 11 SP3 Full Package (Self-Service Support) RPM package | 1908 | 1910 | — |
pacexec binary | 1912 | 1912 | — |
pnabrowse | — | 2103 | storebrowse |
Flash Redirection | 2006 | 2006 | Use Browser Content Redirection (BCR) |
Earlier versions
- Citrix Workspace app 2205 for Linux (PDF Download)
- Citrix Workspace app 2203 for Linux (PDF Download)
- Citrix Workspace app 2202 for Linux (PDF Download)
- Citrix Workspace app 2112 for Linux (PDF Download)
- Citrix Workspace app 2111 for Linux (PDF Download)
- Citrix Workspace app 2109 for Linux (PDF Download)
- Citrix Workspace app 2108 for Linux (PDF Download)
- Citrix Workspace app 2106 for Linux (PDF Download)
- Citrix Workspace app 2104 for Linux (PDF Download)
- Citrix Workspace app 2103 for Linux (PDF Download)
- Citrix Workspace app 2101 for Linux (PDF Download)
Documentation for this product version is provided as a PDF because it isn’t the latest version. For the most recently updated content, see the Citrix Workspace app for Linux current documentation.
Links to external websites found in the preceding PDF take you to the correct pages, but links to other sections within the PDF are no longer usable.
Legacy documentation
For product releases that have reached End of Life (EOL), see Legacy documentation.
Install, Uninstall, and Update
You can install the Citrix Workspace app by downloading the file from the Citrix website at Downloads.
Verify the version of the Citrix Workspace app
Perform the following steps to verify the current version of the Citrix Workspace app installed on your system:
- Open a terminal window.
Run the following command:
For Debian packages:
For RedHat packages:
For Tarball packages:
Manual install
Download the following packages from the Citrix Downloads page.
Debian packages
Install the Icaclient package based on your OS architecture.
To use generic USB redirection, install one of the ctxusb packages based on your OS architecture.
To avoid the compatibility issue, ensure that you install the same version of Icaclient and ctxusb packages.
Package name | Contents |
---|---|
Debian packages (Ubuntu, Debian, Linux Mint etc.) | |
icaclient_ _amd64.deb | Self-service support, 64-bit x86_64 |
icaclient_ _i386.deb | Self-service support, 32-bit x86 |
icaclient_ _armhf.deb | Self-service support, ARM HF |
ctxusb_ _amd64.deb | USB package, 64-bit x86_64 |
ctxusb_ _i386.deb | USB package, 32-bit x86 |
ctxusb_ _armhf.deb | USB package, ARM HF |
Install using a Debian package
When 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’re trying to install.
This procedure uses a command line and the native package manager for Ubuntu, Debian, or Mint. You can also install the package by double-clicking the downloaded .deb package in a file browser. This action 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.
Verify that you have installed all the required system requirements, as mentioned at System requirements section.
To install the package using the command line:
- Log on as a privileged (root) user.
- Open a terminal window.
Run the installation using one of the following commands:
apt – Use the following command to install the Citrix Workspace app with dependency:
To install USB package, run the following command:
dpkg -i – Use the following command to install the Citrix Workspace app:
To install USB package, run the following command:
gdebi – Use the following command to install the Citrix Workspace app:
To install USB package, run the following command:
The ctxusb package is optional to support the generic USB redirection feature
Starting with Version 2101, the following interactive prompt appears asking you to install app protection:
Silent installation of the app protection component on Debian packages
Starting with Version 2102, App Protection is supported on the Debian version of Citrix Workspace app.
For silent installation of the App Protection component, run the following command from the terminal before installing Citrix Workspace app:
Red Hat packages
Install the ICAClient package based on your OS architecture.
To use generic USB redirection, install one of the ctxusb packages based on your OS architecture.
To avoid the compatibility issue, ensure that you install the same version of Icaclient and ctxusb packages.
Package name | Contents |
---|---|
Redhat packages (Redhat, SUSE, Fedora etc.) | |
ICAClient-rhel- .x86_64.rpm | Self-service support, Red Hat (including Linux VDA) based, 64-bit x86_64 |
ICAClient-rhel- .i386.rpm | Self-service support, Red Hat based, 32-bit x86 |
ICAClient-suse- .x86_64.rpm | Self-service support, SUSE based, 64-bit x86_64 |
ICAClient-suse- .i386.rpm | Self-service support, SUSE based, 32-bit x86 |
ctxusb- .x86_64.rpm | USB package, 64-bit x86_64 |
ctxusb- .i386.rpm | USB package, 32-bit x86 |
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.
RPM Package Manager does not install any missing required software.
- For customers using SUSE, download and install the software using zypper install at a command line on OpenSUSE.
- For customers using Red hat, download and install the software using yum localinstall on Fedora/Red Hat.
To install from the RPM package
Verify that you have installed all the required system requirements, as mentioned at System requirements section.
Set up the EPEL repository.
For RHEL and CentOS, install the EPEL repository before you can install the Linux VDA successfully. For information on how to install EPEL, see the instructions.
Run the installation for the following three packages by typing Zypper in
- ctxusb is an optional package. Install the package to support Generic USB Redirection.
- ctxappprotection is an optional package. Install the package only if you want to install the App Protection component.
For SUSE installations:
zypper in ICAClient-suse- .x86_64.rpm
zypper in ctxusb- .x86_64.rpm
zypper in ctxappprotection- .x86_64.rpm
For Red Hat installations:
yum localinstall ICAClient-rhel- .x86_64.rpm
yum localinstall ctxusb- .x86_64.rpm
yum localinstall ctxappprotection- .x86_64.rpm
To install a missing package
On a Red Hat based distribution (RHEL, CentOS, Fedora, and so on), if the following error message appears:
add an EPEL repository (details can be found at https://docs.fedoraproject.org/en-US/epel/).
Tarball packages
Install one of the following packages based on your OS architecture.
Package name | Contents |
---|---|
Tarballs (Script install for any distribution) | |
linuxx64- .tar.gz | 64-bit Intel |
linuxx86- .tar.gz | 32-bit Intel |
linuxarmhf- .tar.gz | ARM HF |
If you want to customize the installation location, install Citrix Workspace app from the tarball package. If you want to install any required packages automatically, install Citrix Workspace app from the Debian package or the RPM package.
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
The tarball package does not do dependency checks nor install dependencies. All system dependencies must be resolved separately.
- Open a terminal window.
- Extract the contents of the .tar.gz file 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 Citrix Workspace app) and press Enter.
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).
If you specify a non-default location, set it in $ICAROOT in $HOME/.profile or $HOME/.bash\_profile .
If you have previously installed GStreamer , you can choose whether to integrate GStreamer with Citrix Workspace app, and 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 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.
If you log on as a privileged user (root), choose to install USB support for Citrix Virtual Apps and Desktops or Citrix DaaS (formerly Citrix Virtual Apps and Desktops service) 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.”
Uninstall
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 .
- To uninstall Citrix Workspace app, you must be logged in as the same user who does the installation.
- When you uninstall the Citrix Workspace app, out of date cache files at $HOME/.local/share/webkitgtk might not be removed automatically. As a workaround, manually remove the cache files.
To uninstall Citrix Workspace app on the tarball package
- Run the setup by typing $ICAROOT/setupwfc and press Enter.
- To remove the client, type 2 and press Enter.
To uninstall Citrix Workspace app on Debian/Ubuntu Operating systems
Run the installation using one of the following commands:
2 Ways to Install Citrix Receiver and Connect to Desktops from Ubuntu and Other Linux
4 min
This guide explains 2 ways to Install Citrix Receiver and Connect to Desktops from Ubuntu and Other Linux.
Many organizations use commercial Citrix technology to provide their employees with remote connections via virtual machines. Citrix uses its proprietary tech to provide connection services.
To connect to a Citrix Virtual machine, you need to install Citrix client software. Citrix provides the client installer for Windows systems which you can just install, and it will work.
However, for Linux, the story is different. Because of various package dependencies and compatibility of the upstream Kernel version – it is sometimes difficult to install Citrix Workspace App (formerly Citrix XenApp plugin).
Here are two ways that you can install and connect to Citrix desktops. The first method requires the installation of packages and requires admin privileges. The second method is browser-based, which requires a Google Chrome browser only (no admin privilege requires).
Method 1: Install Citrix Receiver in Linux and Connect to Desktops
Install Citrix Workspace App for Fedora, Red Hat, and Other .rpm-based distributions
Download the below .rpm package for 64-bit systems. Go to the below link. Click on RPM Packages, then Red Hat Full Package (self-service support). Then click on Download file under “Citrix Workspace app for Linux (x86_64).”
Open the .rpm package via Software or any package manager for installation. All the dependencies should already be present in your current system.
Now, go to the Uses section below on how to use it.
Install Citrix Workspace App for Ubuntu, Linux Mint, and Other Debian-based distributions
Download the below .deb package for 64-bit systems. Go to the below link. Click on Debian Packages, then Full Package (self-service support). Then click on Download file under “Citrix Workspace app for Linux (x86_64).”
Open the .deb package via Software or any package manager for installation. All the dependencies should already be present in your current system.
After the installation, the program will install a Systemd service (/lib/systemd/system/ctxlogd.service), as mentioned below (example). For any troubleshooting, you can check this service.
Now, go to the Uses section below on how to use it.
How to Use Citrix Workspace App
After the successful installation, open any browser and visit your organization’s login page. And try to open the virtual machines.
The virtual machine .ica files should be downloaded. You can click to open it. It will open via Citrix Workspace App by default file associations.
Now, your target desktop should be opening with the native Citrix plugin.
Method 2: Install and Connect to Citrix Desktop via Google Chrome Extension
Go to the below page and click on the “Add to Chrome” for the Citrix Workspace App Chrome Extension.
Remember, this extension is the official Citrix-provided extension. But it will not work in any other Chromium-based browser, e.g. Microsoft Edge, Chromium, Vivaldi, etc.
So, you have to use Google Chrome only to make it work.
How to use Citrix Workspace Chrome Extension
After installation, click on Launch or visit chrome://apps from Google Chrome Browser.
Click on the Citrix Workspace App.
Now, type the URL of your Organization’s Citrix login. And you should be all set.
Troubleshooting and FAQ for Citrix Receiver in Linux
1. ALT+TAB via keyboard doesn’t detect the windows inside Citrix
The keyboard binding should work when you log in to the virtual machine. Sometimes, the ALT+TAB doesn’t work while you are inside the Citrix virtual machines with native windows. Instead, it switches the applications on the host systems.
If this happens, temporarily change the ALT+TAB keyboard binding to something else, e.e. ALT+
in your host system.
2. Trusted certificate error
If you receive the error “you have not chosen to trust the issuer of the server’s security certificate“, follow the below instructions to fix it.
This is caused by the incorrect setup of your Citrix server’s certificates in your client system. It requires manual re-installing of the certificate pem file.
- Firstly, download the pem file from the web browser. If you are using Firefox/or any browser, click on the small “lock” icon at the address bar, then click on More Information.
- Secondly, click on View certificate in the certificate window (this page might look different in Chrome).
- Then select the proper certificate tab (this should match the error you received) and click on Download PEM(cert) under Miscellaneous.
- Open a terminal prompt. And copy the downloaded pem file to /opt/Citrix/ICAClient/keystore/cacerts/ . Make sure you verify the ICAClient installation directory and file name. In addition, this needs to be done by the root user.
Sample command
Finally, re-hash the certificate for final processing using the below command.
Now, refresh the Citrix URL page in your web browser, and you should be able to connect.
For more details about this troubleshooting, visit this page.
Wrapping Up
Finally, I would recommend using the Add-on option if all the options fail for you. I hope this guide to installing the Citrix receiver for Linux helps you to connect to your virtual machine.
Do let me know in the comment box below if this article helps you.