Step by Step – Installing NetScaler Green Bubble Theme with no internet access

For those new to NetScaler and unix (like me), this might save you some time.  In attempting to follow this Citrix blog post on uploading the Green Bubble theme (, I found the instructions are high level and assume you already know your way around a NetScaler :)

I spent nearly an hour messing around trying to determine the exact commands to install this theme without Internet access, so to save others the time and frustration here are the step by step commands.

1. Download the script file and theme to your PC, eg and
2. SSH to your NetScaler (ie use Putty) and enter the shell command
3. Run the following command:

mkdir /var/vpn/customizations

4. Use WinSCP to connect to your NetScaler. Copy the downloaded script file (GreenBubble.txt) to the /root folder and the GreenBubble1.gz file to /var/vpn/customizations
5. Run the following commands:

cd /var/vpn/customizations
gunzip GreenBubble1.gz
tar -xvf GreenBubble1
cd /root
mv GreenBubble.txt
chmod +x

6. Hopefully now you have the theme installed, watch for errors in the script. A successfull output should look like this:

+ basename ./ .sh
+ SKINNAME=GreenBubble1
+ SKINARC=GreenBubble1.gz
+ SKINDIR=/var/vpn/customizations
+ DL=/tmp
+ EPA=ns_gui/epa/epa.html
+ [ -d /var/vpn/customizations/GreenBubble1 ]
+ fgrep var nsversion= /var/vpn/customizations/GreenBubble1/ns_gui/epa/epa.html
+ cut -d -f2
+ echo
+ tr , .
+ nsapimgr -d hwinfo
+ grep Version:
+ sed -e s/Version: NetScaler NS// -e s/: Build /\./ -e s/, Date.*//
+ cut -d. -f1,2,3,4
+ echo
+ tr . ,
+ COMMAVER=10,0,54,7
+ [ != ]
+ cp -rf /var/vpn/customizations/GreenBubble1/ /netscaler/
+ cp ./ /var/vpn/customizations
+ chmod 755 /var/vpn/customizations/
+ touch /nsconfig/
+ chmod 755 /nsconfig/
+ fgrep -q /var/vpn/customizations/ /nsconfig/

7. Reboot and enjoy green bubbly goodness :)

Note that if you have two NetScalers in a HA pair, you will need to perform these steps on both units.

2 thoughts on “Step by Step – Installing NetScaler Green Bubble Theme with no internet access

  1. Hi,

    I have followed above instructions on NetScaler VPX buld however its gives the following error

    root@netscaler01# ./
    + basename ./ .sh
    + SKINNAME=GreenBubble1
    + SKINARC=GreenBubble1.gz
    + SKINDIR=/var/vpn/themes
    + DL=/tmp
    + EPA=ns_gui/epa/epa.html
    + SKINURL=
    + [ -d /var/vpn/themes/GreenBubble1 ]
    + [ -s /tmp/GreenBubble1.gz ]
    + echo ./ Downloading skin archive GreenBubble1.gz to /tmp
    ./ Downloading skin archive GreenBubble1.gz to /tmp
    + perl -e use LWP::Simple; $skin = get ”” ; open(F, ” >/tmp/GreenBubble1.gz” ); print F $skin; close(F);
    + [ 0 -ne 0 ]
    + echo ./ Extracting skin archive /tmp/GreenBubble1.gz
    ./ Extracting skin archive /tmp/GreenBubble1.gz
    + mkdir -p /var/vpn/themes
    + cd /var/vpn/themes
    + tar zxf /tmp/GreenBubble1.gz

    gzip: stdin: unexpected end of file
    tar: Child returned status 1
    tar: Error exit delayed from previous errors
    + exit 1

    any thoughts?

    • Since I originally wrote this post, it looks like the NetScaler builds have changed from using /var/vpn/customizations to /var/vpn/themes – if you change my instructions accordingly does it work?
      (Your output shows it’s trying to download the file from the Citrix website which means it can’t find the local copy you’ve uploaded).

      Alternately, you can upgrade to a more recent NetScaler build and use the built in Green Bubble theme which is available from build onwards.


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s