Citrix Workspace App is the client component of Citrix Workspace. It enables access to a full desktop on a remote host and is available for many different platforms. A colleague recently mentioned it could be installed on a Raspberry. So I have not hesitated and ordered a Raspberry Pi 4 to setup a thin-client for work from home. I use this Raspberry for nothing but Citrix, so I try to keep the number of installed packages at a minimum. Below I will explain how I setup a Citrix Workspace App on Raspbian on a Raspberry Pi 4 with two monitors.
Hardware
The RX420 (IGEL) enterprise thin client, powered by IGEL OS on the latest Raspberry Pi4 platform, brings premium performance and native dual display support to the Citrix Ready Workspace Hub family. It is optimized for Citrix HDX which makes certain that it meets the performance, security and manageability demands of the enterprise. Access desktops, applications from a Raspberry Pi. Download Citrix Workspace app for Linux (ARM HF) and USB Support Package (ARM HF) In a Terminal: sudo apt install./icaclientxxxarmhf.deb./ctxusbyyyarmhf.deb or sudo dpkg -i icaclientxxxarmhf.deb sudo apt -f install sudo dpkg -i ctxusbyyyarmhf.deb. Work around for the certificate store. Built on the Raspberry Pi 3 platform, the Citrix Ready workspace hub provides a secure connection to authorized apps and data. Citrix Workspace app for Android supports user authentication to.
Raspberry Pi 4 Citrix Workspace App
- Raspberry Pi 4 Model B 4GB
- 16GB Class 10 SD Card
- 2 x Monitors 1920x1080
Since I wanted to be sure to have enough RAM, I have gone for the 4GB version. It is definitely not needed for this setup. The memory usage usually is below 500MB, so 2G is definitely enough. I use a 16GB SD card since it was as expensive as a 8GB, Rasbian Lite with all the packages takes 2.5GB. 4GB or 8GB would have been enough.
Install Rasbian Lite
First the Raspbian Buster Lite image is written to the SD card. It can be downloaded from Rasberry downloads. The SD card may not be /dev/mmcblk0 on a different system. The proper device can be found for example with fdisk -l.
If dd cannot be used to write the image to the SD card, there is a guide in Raspberry documentation.
That’s it, given everything is connected to the Raspberry. It can be booted now. Login is pi and password is raspberry. First, the system is updated and then raspi-config can be run to do some basic configuration.
In order to use the complete screen, overscan is deactivated. Since it is not intended to use this raspberry for anything else than Citrix, it is more convenient to autologin after boot.
- Deactivate overscan: 7 Advanced -> A2
- Autologin into console: 3 Boot -> B2
- Update timezone: 3 Localization -> I2
- Reboot after configuration
Setup window manager and browser
For this thin-client there is no desktop environment with office software, games etc. required. It only needs a browser to get a Citrix session and Citrix Workspace App. If only one monitor is used, almost any window manager can be used. With two monitors it has shown slightly more difficult, Citrix gets _NET_WM_FULLSCREEN_MONITORS message, which is set by the window manager.1 It appears, many window managers do not set this variable. Of the low-footprint window managers I have tried, only xfwm4 and icewm work out of the box with multiple monitors. dwm, jwm and fluxbox have worked with one monitor only. So I have chosen xfwm4, because it looks nicer. To get a Citrix connection, I do need a browser. I chose Midori, because it feels light.
Since I do not want to have any transparency, shadows etc. I deactivated the xfwm4 compositor. The settings menu can be opened through bash.
The window manager should be started when autologin starts bash. So we add the xfce4-panel and xfwm4 to .xinitrc.
And then startx in .bashprofile.
After this we can reboot into xfwm4.
Setup Citrix workspace
So far we have prepared a minimal Raspbian, with a window manager and a browser. Now we can download Citrix Workspace app for Linux (ARM HF) from Citrix for Linux. Make sure to download the ARM version for Debian.
Citrix Workspace App Windows
Assuming Workspace app has been downloaded to Downloads, it can the be installed with dpkg. In case there are any packages missing, installation will fail and the missing package will be reported. The missing package can be installed with apt install missing-package and then Workspace app installation with dpkg can be tried again.
Make ssl certificates available to ICAClient.
In case the certificate of your companies website is not trusted, you can add it to your certificates and update the certificates.
Citrx Configuration
For my headset to work on the remote host, I also installed Pulseaudio plugin and changed the AllowAudioInput in ~/wfclient.ini to true.
wfclient.ini:
In different applications I use mouse middle click, e.g. to close tabs or to open in a new tab. The default Citrix configuration remaps mouse middle click to paste (ctrl + v). I commented this line with a semicolon.
Backup
Finally, I made a backup of my Raspberry on my notebook.
Start Citrix
- Get Citrix connection file
- Open downloaded icx file
References