In my last post Securing Citrix X1 StoreFront with Powershell I showed you how to use Powershell to import and bind your certificate to all your Citrix Delivery Controllers and StoreFront Servers. This is a requirement to enable SSL in all moving parts of your Citrix environment.
As explained in my post Citrix NetScaler Gateway and StoreFront Customization, it’s very hard to find information online that cover both parts of the customization. So let me show you how to customize the new X1 look on NetScaler and StoreFront.
The main files you want to start working with are located in C:\inetpub\wwwroot\Citrix\StoreWeb\receiver\images\1x and 2x.
- ReceiverFullScreenBackground_46E559C0E6B5A27B.jpg = Background Image
- CitrixReceiver_WebScreen_CBE548FB8FEE049E.png = Login Page Logo
I don’t understand why Citrix name these files in this incredible strange way, but that’s probably another story. I could of course use CSS to change those, but I’m awaiting more information from Citrix instead of wasting my time digging into CSS classes.
The site Pexels provides a lot of great looking images that you can use without any complicated licenses.
In this example, I’m going to use the image below. The file has been downloaded, re-sized to 2560 x 1600 px and the size optimized.
Before you start, make sure to make a copy of C:\inetpub\wwwroot\Citrix.
Let’s see how the new X1 StoreFront design look like out of the box.
Now let’s rename the above background image to ReceiverFullScreenBackground_46E559C0E6B5A27B.jpg and copy/paste it into C:\inetpub\wwwroot\Citrix\StoreWeb\receiver\images\2x.
That looks nice. Let’s change the Citrix Receiver logo to something else.
The login page logo is a 130 x 52 px transparent image. Rename your logo image to CitrixReceiver_WebScreen_CBE548FB8FEE049E.png and copy/paste it into C:\inetpub\wwwroot\Citrix\StoreWeb\receiver\images\1x.
The new X1 StoreFront let’s you customize some parts inside the console – Receiver for Web – Customize Website Appearance and Manage Featured App Groups.
Let’s change the logo and the background color.
The new Feature Apps Groups are pretty cool. I’m going to create 3 of those using the Application Category.
Now for the apps to show up I need to open Citrix Studio and edit the application properties.
Let’s take a look.
Since I used Application Category they also shows up as Folders.
Now that the internal StoreFront is customized, it’s time to to change the look of our NetScaler Gateway.
@powershell -NoProfile -ExecutionPolicy unrestricted -Command "iex ((new-object net.webclient).DownloadString('https://chocolatey.org/install.ps1'))" && SET PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin
choco install putty
choco install winscp
Connect to the Netscaler GUI and navigate to NetScaler Gateway – Global Settings – Change Global Settings – Client Experience and set UI Theme to Green Bubble.
Now connect to your NetScaler with WinSCP. Copy the files bg_bubbles.jpg and logo_notagline.png to \var\netscaler\gui\vpn\media and ctxs.authentication.css to \var\netscaler\gui\vpn\css.
- bg_bubbles.jpg = Background Image
- logo_notagline.png = Login Page Logo
The new X1 Custom Login page will look like this. It’s not identical but close enough!
If you pay very good attention you’ll see that the green bar all the way at the left has been removed by my custom ctxs.authentication.css.
When you’re happy with your design connect to your NetScaler with Putty.
Run the following commands:
cp ns.conf ns.conf.save
tar -cvzf /var/ns_gui_custom/customtheme.tar.gz ns_gui/*
This creates the file customtheme.tar.gz which are used by NetScaler Gateway and also makes sure the NetScaler Gateway Customization is retained after reboot. The final step is to change UI Theme from Green Bubble to Custom in NetScaler Gateway – Change Global settings – Client Experience.
When you do a NetScaler firmware upgrade you need to switch back to Default or Green Bubble, upgrade the firmware and then redo your customzations as shown above. The reason is that sometimes the AdminUI and EPA files changes together with the firmware upgrade.
Click here to download my sample files for Citrix NetScaler Gateway and X1 StoreFront Customization.
For more X1 StoreFront Customization check out Richard Hayton on the Citrix blogs.