Upgrade the NetScaler Gateway software

Last published : Sep 03, 2026
You can upgrade the software that resides on NetScaler Gateway when new releases are made available. You can check for updates on the Citrix website. You can upgrade to a new release only if your NetScaler Gateway licenses are under the Subscription Advantage program when the update is released. You can renew Subscription Advantage at any time. For more information, see the NetScaler support website.
The upgrade path and compatible products information are also available in the Citrix Upgrade Guide.
For information about the latest NetScaler Gateway maintenance release, see the NetScaler release notes.

Check for software updates

  1. Go to the Citrix website.
  2. Click My Account and log on.
  3. Click Downloads.
  4. Under Find Downloads, select NetScaler Gateway.
  5. In Select Download Type, select Product Software and then click Find. You can also select Virtual Appliances to download NetScaler VPX. When you select this option, you receive a list of software for the virtual machine for each hypervisor.
  6. On the NetScaler Gateway page, expand NetScaler Gateway or Access Gateway.
  7. Click the appliance software version you want to download.
  8. On the appliance software page for the version you want to download, select the virtual appliance, and then click Download.
  9. Follow the instructions on your screen to download the software.
When the software is downloaded to your computer, you can use the Upgrade Wizard or the command prompt to install the software.

Upgrade the NetScaler Gateway by using the Upgrade Wizard

  1. In the configuration utility, on the Configuration tab, in the navigation pane, click System.
  2. In the details pane, click Upgrade Wizard.
  3. Click Next and then follow the directions in the wizard.

Upgrade the NetScaler Gateway by using a command prompt

  1. To upload the software to NetScaler Gateway, use a secure FTP client, such as WinSCP, to connect to the appliance.
  2. Copy the software from your computer to the /var/nsinstall directory on the appliance.
  3. Use a Secure Shell (SSH) client, such as PuTTY, to open an SSH connection to the appliance.
  4. Log on to NetScaler Gateway.
  5. At a command prompt, type: shell
  6. To change to the nsinstall directory, at a command prompt, type: cd /var/nsinstall
  7. To view the contents of the directory, type: ls
  8. To unpack the software, type: tar –xvzf build_X_XX.tgz, where build_X_XX.tgz is the name of the build to which you want to upgrade.
  9. To start the installation, at a command prompt, type: ./installns
  10. When the installation is complete, restart NetScaler Gateway.
After NetScaler Gateway restarts, to verify successful installation, start the configuration utility. The NetScaler Gateway version that is on the appliance appears in the upper-right corner.