Configuring Citrix ADC CPX

You can configure a Citrix ADC CPX instance by accessing the CLI prompt through the Linux Docker host, or by using the Citrix ADC NITRO APIs.

Configuring a Citrix ADC CPX Instance by Using the Command Line Interface

Access the Docker host and log on to the SSH prompt of the instance as shown in the following figure. The default administrator credentials to log on to a Citrix ADC CPX instance are root/linux.

Localized image

Type the following command to use the command line prompt of the instance to run CLI commands: “<command>”


Localized image

To log out of the instance prompt, type logout.

Support for using a non-default password in Citrix ADC CPX

Citrix ADC CPX supports using a non-default password for the root account, that is nsroot. A default password is generated and assigned to the user once Citrix ADC CPX has been deployed. This default password is also updated for SSH users: root and nsroot. You can change this default password manually. You can also reset the default SSH password for root and nsroot user accounts manually. Citrix recommends changing this password manually to preserve the security of the system.

Once you reset your password, the new password is used for NITRO API communications and executions. The default root account password is stored in plain text in the /var/deviceinfo/random_id file in the Citrix ADC CPX file system.

Use the following syntax for running with the credentials: "<command>" ":<user>:<password>"

For example, to run for displaying IP addresses with user nsroot and password Citrix123, use the following: "show ns ip" ":nsroot:Citrix123"

Configuring a Citrix ADC CPX Instance by Using the NITRO API

You can use the Citrix ADC NITRO API to configure Citrix ADC CPX instances.

To configure Citrix ADC CPX instances by using the Nitro API, in a web browser, type:


To retrieve statistics by using the Nitro API, in a web browser, type:


For more information about using the NITRO API, see REST Web Services. For Citrix ADC CPX, use CPX IP address:port where netscaler-ip-address is mentioned.

Configuring a Citrix ADC CPX Instance by Using Jobs

You can configure Citrix ADC CPX instances by creating and running jobs in Citrix ADM. You can use the configurations from configuration templates, extract configurations available on other devices, and use configurations saved in text files. You can also record configurations done by using the configuration utility of another instances. Citrix ADM then displays the corresponding CLI commands for you to use on your Citrix ADC CPX instance. After you select the configuration, you must then select Citrix ADC CPX instances on which you want to load the configuration, specify the variable values, and run the job.

To configure Citrix ADC CPX instances by using Jobs:

  1. Log on to Citrix ADM by using the administrative credentials.

  2. Navigate to Networks > Configuration Jobs, and then click Create Job.

  3. Specify the required values, and select the configuration source. You can also type the commands you want to run. localized image

  4. Select the Citrix ADC CPX instances on which you want to run the configuration and click Next. localized image

  5. Specify the execution settings and click Finish to run the commands on the Citrix ADC CPX instance. If you want to save the configuration and run it later, click Save and Exit. localized image

Configuring Citrix ADC CPX