Raspberry Pi – A Citrix Receiver Thin Client

There has been more buzz than usual at the office regarding VDI, a discussion where my boss took more interest in the technology and price points than I would expect – considering we had more or less dismissed the technology for use in our environment in the past. Even so, It started a good conversation – especially in regards to the cost of some of the “Thin Clients” available on the market today. As luck would have it I just purchased a Raspberry Pi unit and was trying to figure out what I wanted to do for my first project – This seemed as good a project as any, so I started doing my research… Well it turns out I’m not alone – It seems there is already an ambitious project underway to create a viable thin client solution using the Raspberry Pi. The good folks @ rpitc.blogspot.com have put together a wheezy based Raspberry Pi image with all the essentials 😀


Installing The Raspberry Pi Thin Client OS


1.) Download the latest RPITC Raspberry Pi image @ http://rpitc.blogspot.com/

2.) Download Win32DiskImager.

3.) Extract the .img file from your zipped download of the Raspberry Pi Thin Client OS.

4.) Open Win32DiskImager, Select the .img file & select your SD card then click Write.


5.) After the write process has finished, simply eject the SD card and pop it in your Raspberry Pi and fire it up!


I’ve found that most users recommend running the below commands to update your image. It shouldn’t be necessary to get a working machine, but it is recommended 🙂

Upgrading The Citrix Receiver Client

I created this section before the latest release of the RPITC OS contained v13 of the Citrix Receiver Client. I recommend that you download the latest version if you are starting from scratch, however you should be able to use the below method for future upgrades of the Citrix Receiver client as well 😀

Click title to expand
[learn_more caption=”Upgrading to the latest version of Citrix Receiver”]

In order to upgrade to the latest version of the Linux Citrix Receiver client we have to force the upgrade by running the following command:

Towards the end of the upgrade you will be prompted several times to update a few config files, Select Yes during each one of these prompts if you are installing this on a new RPITC Raspberry Pi image.

After the upgrade our Symlink from our mozilla security certificates will be broken, so we will want to re-create this link with the following command:


Next we will have to fix the AutoStart link for Citrix….
R-Click Desktop > Configurations > Change Autostart Applications


And finally we will want to update our R-Click Menu with the new Citrix Paths as well…
R-Click Desktop > Configurations > Change This Menu

There should be 2 similar entries to the one shown below – you will want to change the Item label name as well as the command entry as shown:


Reboot again and you should be prompted by a license agreement from the citrix receiver, followed by a prompt to enter your Citrix Server credentials. (It is rather picky when it comes to the format of the server address) Once the Citrix receiver client gets a proper server address – It should prompt you for your credentials:D Finally, reboot one last time and you are finished!

  Additional Information


To Configure session behavior Browse to:
R-Click > Configurations > File Browser > /opt/Citrix/ICAClient/util/configmgr

To Set the Date/Time/ Timezone:


There are 2 really helpful optimization tutorials on the RPiTC website if you are looking to eek out more performance from your Raspberry Pi Thin Client…


I’ve decided to break this project post up into 3 different sections, Check out the other steps involved in this project in my other Posts!



  1. Adriano