HowTo: Run a Citrix NetScaler VPX on Oracle VirtualBox


As a consultant I’m on the road a lot and tend to work at different customers and sites. And some customers and sites offer limited internet access due to security policies. This means I’m not always able to connect to the PepperByte lab environment for testing purposes or to simply check a particular settings in our reference setup.

So for my mobile offline days I was looking for a way to take my lab with me without having to carry a box full of additional hardware. Which basically translates into the need to run a VDI infrastructure on my MacBookPro, while keeping the costs of this additional lab environment as low as possible.


I decided to give Oracle’s VirtualBox a go as it offers enough functionality to run a portable Citrix XenDesktop demo environment. And as I am running more and more NetScaler configurations for customers and having some fun with automating the configurations with PowerShell and NITRO scripting, I was very happy to discover that with some adjustments to the VM settings, it is also capable of running a NetScaler VPX as well.

So it was long overdue to share the steps I took to run a NetScaler VPX in my Oracle VirtualBox demo lab on my MacBookPro as well 😉


Which NetScaler VPX download to pick?

There is no VirtualBox download variant for the NetScaler VPX, so after finding this great forum post on I knew I needed to select the NetScaler VPX for ESX download.


Tell VirtualBox it’s an ESX VM

Not only did the mentioned forum post tell me which Hypervisor edition to download, it also explained how I could tell VirtualBox I wanted it to run the VM as an ESX compatible VM by configuring some additional settings for the virtual machine.

To configure the extra VM settings, you’ll need to use the VBoxManage commandline utility, which can be run from a Terminal session on your MacBookPro.


* Navigate to the VBoxManage executable location in the Terminal session:

First you’ll need to navigate to the folder that contains the VBoxManage executable. By default you can find the VBoxManage executable at the following location:

cd /Applications/


* Configure the VirtualBox VM as a VMware Virtual Platform VM:

Than you can run the required commands to configure the VM as an ESX compatible VM:

VBoxManage setextradata [VM] "VBoxInternal/Devices/pcbios/0/Config/DmiBIOSVendor" "Phoenix Technologies LTD"
VBoxManage setextradata [VM] "VBoxInternal/Devices/pcbios/0/Config/DmiBIOSVersion" "6.00"
VBoxManage setextradata [VM] "VBoxInternal/Devices/pcbios/0/Config/DmiBIOSReleaseDate" "07/31/2013"
VBoxManage setextradata [VM] "VBoxInternal/Devices/pcbios/0/Config/DmiBIOSReleaseMajor" 6
VBoxManage setextradata [VM] "VBoxInternal/Devices/pcbios/0/Config/DmiBIOSReleaseMinor" 0
VBoxManage setextradata [VM] "VBoxInternal/Devices/pcbios/0/Config/DmiBIOSFirmwareMajor" 6
VBoxManage setextradata [VM] "VBoxInternal/Devices/pcbios/0/Config/DmiBIOSFirmwareMinor" 0
VBoxManage setextradata [VM] "VBoxInternal/Devices/pcbios/0/Config/DmiSystemVendor" "VMware, Inc."
VBoxManage setextradata [VM] "VBoxInternal/Devices/pcbios/0/Config/DmiSystemProduct" "VMware Virtual Platform"

Which uses the following syntax:

  • VM: The name of the NetScaler VPX instance in VirtualBox. For example NSVPX-ESX.
    (Note: use double quotes when the name contains spaces).


Keep in mind that running the NetScaler VPX in Oracle’s VirtualBox is a not supported configuration and should only be used for testing or developing purposes.
Don’t use this configuration for production environments!


For those who are running VirtualBox on a Windows system, the default location of the VBoxManage executable is “C:\Program Files\Oracle\VirtualBox”




Esther Barthel
Senior Consultant at PepperByte

Esther has been working in different roles and functions as an IT consultant ever since she finished her Masters degree in Computer Science in 1997. She has worked as a web developer, database administrator, and server administrator until she discovered how Server-Based Computing ( SBC ) combined servers, desktops, and user experience in one solution. Esther has been specializing in virtualization solutions such as SBC, VDI, application, and server virtualization for over eight years now and is currently working as a Senior Consultant at PepperByte, where she designs and implements Citrix® solutions for both small-business and large-enterprise infrastructures scaling from 100 to 15,000 users.
In january 2014 her first book Citrix XenApp 6.5 Expert Cookbook was published by Packt Publishing.

Esther is awarded as a Citrix Technology Professional (CTP) from 2015 - 2017.
Esther is awarded as a Microsoft Most Valuable Professional (MVP) in 2017.

Esther is a Citrix Certified Expert – Virtualization (CCE-V), Citrix Certified Professional – Mobility (CCP-M), Citrix Certified Professional – Networking (CCP-N) and RES Software Certified Professional (RCP).