Follow these instructions to install the NSX agent on your Linux workload VMs.

See Supported Operating Systems for a list of Linux distributions currently supported.


You need the wget and nslookup commands to run the NSX agent installation script.


  1. Log in to CSM and go to your public cloud:
    1. If using AWS, go to Clouds > AWS > VPCs. Click on the VPC on which one or a pair of PCGs is deployed and running.
    2. If using Microsoft Azure, go to Clouds > Azure > VNets. Click on the VNet on which one or a pair of PCGs is deployed and running.
  2. From the Agent Download & Installation section of the screen, make a note of the Download Location and the Installation Command under Linux.
    Note: The DNS Suffix in the Installation Command is dynamically generated to match the DNS settings you choose when deploying PCG.
  3. Log in to the Linux workload VM with superuser privileges.
  4. Use wget or equivalent to download the installation script on your Linux VM from the Download Location you noted from CSM. The installation script is downloaded in the directory where you run the wget command.
  5. Change permissions on the installation script to make it executable if required, and run it:
    $ sudo chmod +x
    $ sudo bash --dns-suffix <>
    Note: On Red Hat Enterprise Linux and its derivatives, SELinux is not supported. Disable SELinux to install the NSX agent.
  6. You lose connection to your Linux VM after NSX agent installation begins. Messages such as the following appear on your screen: Installation completed!!! Starting NSX Agent service. SSH connection will now be lost.. Reconnect to your VM to complete the onboarding process.


The NSX agent is installed on your workload VM(s).

  • After the NSX agent is successfully installed, port 8888 shows as open on the VM but it is blocked for VMs in the underlay mode and should be used only when required for advanced troubleshooting.
  • The script uses eth0 as the default interface. For a list of script options, and uninstallation instructions, see NSX Agent Install Script Options for Linux VMs

What to do next

Manage Workload VMs