Home > Citrix XenApp, Citrix XenDesktop > How to Deploy Citrix Receiver or Online Web Plugin for XenApp 6.5 on Web Interface 5.4

How to Deploy Citrix Receiver or Online Web Plugin for XenApp 6.5 on Web Interface 5.4

After your install XenApp 6.5 and setup your web interface site under Web Interface 5.4, you may notice that going to the web interface will show you a plugin install page like this if you don’t have the right web plugin installed on your system:

The problem is when you click on this install button, it takes the user to:


where they have to dig around and find the proper plugin. This is a horrible end user experience because they don’t know what to download and can get confused and frustrated.

So instead, you can host the web plugins for the different OSes on your web interface server itself just like previous editions of Web Interface. Here are the steps to do this. I installed on XenApp 6.5 and Web Interface 5.4 on a Server 2008 R2 for this example so these are 64 bit paths. Just edit the path below to regular “Program Files” if you are using a 32 bit OS.

1. Go to:

c:\Program Files (x86)\Citrix\Web Interface\5.4.0\Clients

you will notice it is empty like below:

2. Now go to your XenApp 6.5 media/install files and drill down to the Windows clients folder:

Citrix Receiver and Plug-ins\Windows

3. Copy the “Windows” folder into the “c:\Program Files (x86)\Citrix\Web Interface\5.4.0\Clients” folder. You can also copy over the Java, Linux, and Mac folders if you support those clients but in this example, I am only copying over the Windows clients.

4. Once everything is copied, go into the Windows folder and you will see all the clients listed:

5. Now go to the Web Interface console and click Client Deployment on your XenApp website. Make sure “Offer upgrades for clients” is checked if you want users to be prompted to upgrade their clients when they hit the WI and are detected to be running an old version. By default this is unchecked and that is fine if you don’t want to give them an option to update just yet.

7. Now the fun part, go to:


and open the WebInterface.conf file in Notepad. Scroll down till you get to the ICA clients section which is commented out by default.

8. Since Citrix Receiver 3.0 that is currently shipping with XenApp 6.5 has the Online Plugin version embeded, you can uncomment this line and instead of “CitrixOnlinePluginWeb.exe” type “CitrixReceiver.exe”. This will give users the option to install the Citrix Receiver instead of a legacy Online Plugin:

9. You don’t have to do an iisreset as the change should be instant but for good measure, you can:

10. Now when you go to the web interface in your browser, you will notice the green Install button is there but there is also a little check box underneath that says “I agree with the Citrix license agreement”. This means the install file is being hosted on the web interface server now. Check the box and hit Install:

11. Save or Open the file depending on what your browser prompts you with (I am using Firefox):

12. Run the file to install the Citrix Receiver:

13. It will prompt when complete unlike some older Online Plugin versions:

14. Click Continue on the Web Interface once the installation is complete:

15. Now you can logon. If you have passthrough authentication enabled, it should log you in automatically if using Internet Explorer. In Firefox, make sure to enable NTLM passthrough for the URL and it will do the same. Here is my article I wrote a while back on how to do this targeted at Sharepoint admins but the same steps will work for your web interface URLs:


Otherwise it will give you the Explicit logon prompt:

15. Now you may not want to deploy Citrix Receiver to your end users and just want to remain on a legacy version of Online Plugin. This is fine too. All you have to do is manually create a “Online Plug-in” folder under:

c:\Program Files (x86)\Citrix\Web Interface\5.4.0\Clients

and drop your legacy plugin executable in there:

and then make sure your WebInterface.conf is uncommented and says “CitrixOnlinePluginWeb.exe”:

16. If you want to force your users to run a minimum version of the Online Plugin or otherwise get the “Install the latest plugin” screen, you can append the version number to the end of the string. In this example, I only want to let users connect and bypass the Install screen who are using 11.2 or greater so I typed:


A few things to note on client detection and Firefox vs. Internet Explorer. IE can detect the difference between lets say version vs. But Firefox cannot. Firefox can only detect if a client is installed or not, it cannot detect version numbers. So if you specify in your WebInterface.conf that only 12.0 clients can connect without the update screen and the user connects using 11.2 with Firefox, they will not get the update screen. If you run a manual client detection under Settings > Run Client Detection, it will say “The preferred client is already available on your computer.”

In IE, it detects the client version just fine. To test, make sure a legacy online web plugin is installed on your system such as for example. Edit your WebInterface.conf like above and set the version to “”. Hit the web interface and you will passthrough with no issue. Now edit the string again and change it to “”. Try going to the web interface and you will now get a prompt asking you to update.

So please keep the browser client detection issues in mind if you do allow your users to run browsers other than Internet Explorer. There are better ways to rollout a client update to your user base that are more controlled and less “error prone” if browser flavor is a concern in your environment.

  1. Hardeep
    September 1st, 2011 at 11:06 | #1

    Can users install this without admin rights?

  2. September 1st, 2011 at 12:57 | #2


    Unfortunately no, the user cannot install the client without being a local admin on the workstation. You can push the install using GPO or you can let the user fallback to the Client for Java.

  3. steven stirling
    September 2nd, 2011 at 08:01 | #3

    Citrix claims you can install the regular receiver client without admin rights, it’s the enterprise version that requires them.

  4. Hardeep
    September 2nd, 2011 at 09:47 | #4

    I had time to test this today with a computer that had “online web plugin v12″ installed and with a user without admin rights. It didn’t work. Take a look… http://goo.gl/ZhuI3

  5. Hardeep
    September 2nd, 2011 at 09:50 | #5

    Also wanted to add that I was trying to install receiver for web access and not receiver Enterprise.

  6. September 2nd, 2011 at 13:08 | #6

    I know that the Online Web Plugin (pre-version 13) could be installed without admin rights by the user (and only for that user, not everyone on the PC). It installs to that users AppData folder only. But I have not tried it with Receiver 3.0/Online Web plugin 13 yet. I was under the impression Receiver required admin rights to install. I think I was confusing it with Receiver Updater 3.0 (the one that works with Merchandising Server to update Receiver and all the plugins).

    But Steven is correct, the 3.0 manual says it can be installed without admin rights like the previous online plugins:


    “Citrix Receiver (standard) is a smaller package that is installed with the CitrixReceiver.exe installer file. Administrative rights are not required to install this package, enabling installation by standard users.”

    Hardeep, your screenshot doesn’t work for me. But if you are getting an error saying another version of the plugin is installed, this is normal if it is pre 11.1. You have to uninstall the old version and install Receiver 3.0 for it to work. I actually had a similar compatibility error because I had the Receiver Enterprise client installed already and had to uninstall it for Receiver 3.0 to work. Please double check the version installed on the users PC.

  7. AnalogKid
    September 5th, 2011 at 00:07 | #7

    That worked like a charm and saved me a bunch of time. Thanks!

  8. Frank
    October 19th, 2011 at 13:45 | #8


    Thanks very much for the information, work very good!!



  9. Prince
    October 30th, 2011 at 23:06 | #9

    Many thanks!

  10. November 3rd, 2011 at 09:16 | #10

    Excellent blog post and saved me from wasting a whole load of time trying to work out why the clients wouldn’t download – thanks!

  11. john griffin
    November 20th, 2011 at 20:51 | #11

    Excellent post Jason. Found this extremely helpful. If only Citrix had this quality of documentation on their website…

  12. November 21st, 2011 at 10:11 | #12

    Thanks everyone, glad to help!

    @john griffin

    Thank you John, that is very flattering. :)

  13. Andrea Nielsen
    November 30th, 2011 at 10:58 | #13

    I can get this to work on firefox but on IE version 8 I get this error:

    An error occurred while trying to access the requested resource. Contact your system administrator. Log ID: 24aa9a66

    Any suggestions ? Thanks for the post!

  14. Andrea Nielsen
    November 30th, 2011 at 11:27 | #14

    Nevermind I figured it out. I had to uncheck display settings button to users under Session Settings, General, User Customizations. It works like a champ now. Thanks again.

  15. stagnant
    December 1st, 2011 at 09:15 | #15

    Thank you SO much! This worked perfectly for me. Much easier than scouring the Citrix documentation for a straightforward guide!

  16. Fred
    December 9th, 2011 at 04:41 | #16

    Thank you Jason, works great !

  17. Davdi
    December 15th, 2011 at 09:28 | #17

    Great Article!!! Worked like a charm.

  18. David
    December 15th, 2011 at 09:29 | #18

    Great Article!!! Worked like a charm. Thanks for the post!!

  19. Clint
    December 29th, 2011 at 09:14 | #19

    Has anyone had problems with enterprise receiver 3.0 and windows xp? It will install for me but once the user WITHOUT admin rights tries to run a hosted application on xenapp it errors.

    WIndows 7 works fine

    Anyone see this?


  20. Dimix37
    January 24th, 2012 at 14:06 | #20


    It could be stupid, but, be careful if your explorer hide the extension.
    I lost 20min only because my client was in fact : CitrixOnlinePluginWeb.exe.exe.
    I know, it’s stupid, and annoying !

    After, everything work’s fine.

    I would like add an observation : the WebInterface doesn’t take care about sub-directory path, and find the “ClientIcaWin32=Filename:” value (CitrixOnlinePluginWeb.exe), independant of the path inside Clients/Windows directory.

    Thanks for your article !

  21. Mark W
    January 26th, 2012 at 14:57 | #21

    This posting is great and works like a charm.

    I have a followup question. After the first user installs the citrix receiver, any other user is still presented with the install button even though the citrix receiver is installed. Once these subsequent users enable the ActiveX control they are presented with the expected login screen. Is this what my users can expect or is there a way to detect that the receiver is installed and not present that screen?

    Thanks in advance,

  22. Rob C
    February 15th, 2012 at 09:03 | #22

    Thank you for the infomation. This worked AWESOME!!!

  23. February 16th, 2012 at 16:51 | #23

    Thanks Jason for sharing your wealth (knowledge)… Appreciated!


  24. James Y.
    February 17th, 2012 at 09:21 | #24

    Great Howto! Thanks for sharing.

  25. Kevin W.
    February 17th, 2012 at 11:37 | #25

    Does anyone know how to make this work with citrix merchandise server?

  26. February 24th, 2012 at 08:07 | #26

    You can also use Citrix Receiver Package Installer switches to deploy the receiver through policy. This is seemless to users.

    To configure and install the Citrix Receiver for Windows using command-line parameters


  27. Justin
    April 19th, 2012 at 10:12 | #27

    great info, thanks much for the article.

    I adjusted mine to push the enterprise receiver, worked like a charm!

  28. dum-dum
    September 17th, 2012 at 14:09 | #28

    Our Web Portal page doesnt seem to detect any local instances of Reciever, regardless of client OS. Is there something in the webconfig I can check?

  29. Joshua
    July 26th, 2013 at 12:39 | #29

    Just wanted to say thank you. This certainly helped us out.

  1. December 9th, 2011 at 03:11 | #1
  2. April 15th, 2012 at 01:14 | #2
  3. February 23rd, 2013 at 13:53 | #3

NOTE: Due to increased spam, your comment may not immediately appear on the site until validated.