Application Delivery Management

Install a NetScaler® agent as a microservice on a Kubernetes cluster

February 18, 2026

Contributed by:

C R

If you are using NetScaler Console on-premises, the container agent is used for several specific strategic and technical reasons. Some of the important reasons are:

Seamless Management of Cloud-Native Workloads - The primary reason for using the container agent is to manage NetScaler CPX (the containerized version of NetScaler).
Localized Control: The agent acts as a licensing proxy between your on-prem Console and NetScaler CPX instances running inside a Kubernetes cluster.
Simplified Connectivity (Microservices Architecture) - If your NetScaler Console and your Kubernetes cluster are on different networks, the container agent acts as a secure “in-cluster” gateway.

Notes:

You can also configure an on-prem agent and register the agent on the network where the Kubernetes cluster is hosted.

Starting from NetScaler Console release 14.1 build 60.x, NetScaler Console supports the use of containerized console agent. Use of a containerized console agent provides streamlined connectivity and monitoring of managed instances on Kubernetes or OpenShift platforms.

Getting started

In NetScaler Console, navigate to Infrastructure > Instances > Agents.
From the Select Action list, select the Download Agent Microservice option.
In the Download Agent Microservice page, specify the following parameters:
- Application ID – A string id to define the service for the agent in the Kubernetes cluster and distinguish this agent from other agents in the same cluster.
- Password – Specify a password for NetScaler CPX to use this password to onboard NetScaler CPX to NetScaler Console through the agent.
- Confirm Password – Specify the same password for confirmation.
  Note:
  - You must not use the default password (nsroot).
Click Download Yaml File.

Install NetScaler agent in Kubernetes cluster

Perform the following steps in the Kubernetes main node:

Save the downloaded YAML file.

Run the following command:

kubectl create -f <yaml file>
<!--NeedCopy-->

Example:

kubectl create -f onprem6540.yaml
<!--NeedCopy-->

The agent is successfully created.

NetScaler agent created in Kubernetes cluster

In NetScaler Console, navigate to Infrastructure > Instances > Agents to see the agent status.

NetScaler agent created in the Kubernetes cluster by using the NetScaler Console GUI

After you configure the agent, you can add the NetScaler CPX instances and view analytics in the service graph. For more information, see:

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Was this helpful

NetScaler Secure Deployment Guide

Install a NetScaler® agent as a microservice on a Kubernetes cluster

February 18, 2026

Contributed by:

C R

February 18, 2026

Contributed by:

C R

Install a NetScaler® agent as a microservice on a Kubernetes cluster

Getting started

Install NetScaler agent in Kubernetes cluster

In this article