Product Documentation

Creating a Custom Theme for the Logon Page

Feb 28, 2014

You can use the configuration utility to create a custom theme for the logon page for NetScaler Gateway. You can also leave the default theme or use the Citrix Receiver theme. When you choose to apply a custom theme to the logon page, you use the NetScaler Gateway command line to create and deploy the theme. You then use the configuration utility to set the custom theme page.

You configure the custom theme page by using NetScaler Gateway global settings.

You can use this feature with the following versions of NetScaler Gateway:

  • NetScaler Gateway 10.1
  • Access Gateway 10, Build 73.5002.e (you must install this build after Build 71.6104.e to use this feature with AppController Versions 2.5, 2.6, or 2.8)
  • Access Gateway 10, Build 71.6104.e

To create and deploy the custom theme by using the command line

  1. Log on to the NetScaler Gateway command line.
  2. At a command prompt, type shell.
  3. At command prompt, type mkdir /var/ns_gui_custom; cd /netscaler; tar -cvzf /var/ns_gui_custom/customtheme.tar.gz ns_gui/* .
  4. Use the configuration utility to switch to the custom theme and then make customization changes under /var/ns_gui_custom/ns_gui/vpn. You can:
    • Make edits to the css/ctx.authentication.css file.
    • Copy a custom logo to the /var/ns_gui_custom/ns_gui/vpn/media folder.
      Note: You can use WinSCP to transfer the files.
  5. If you have multiple NetScaler Gateway appliances, repeat Steps 3 and 4 for all appliances.

To apply the custom theme by using the configuration utility

  1. In the configuration utility, on the Configuration tab, in the navigation pane, expand NetScaler Gateway and then click Global Settings.
  2. In the details pane, under Settings, click Change global settings.
  3. In Global NetScaler Gateway Settings, click the Client Experience tab.
  4. Next to UI theme, click Custom and then click OK.
Note: If you upgrade NetScaler Gateway from an earlier version, Citrix recommends that you set the theme back to the default theme page. When the upgrade is complete, you can use the either of the preceding procedures to apply the custom theme page.