Netskope LogoNetskope Logo
  • Security Services
  • AI Services
  • Networking Services
  • Analytics Services
  • Integrations
  • getting-started.svgGetting Started
    • Support
    • Community
    • Netskope.com
    © 2026 All Rights Reserved. Netskope Inc.
    Home
    Appliances
    Virtual Appliance
    Virtual Private Edge
    Deploying Virtual Private Edge

    Deploying Virtual Private Edge

    For Virtual Private Edge (VPE), you must deploy and register VPE Nodes, which are the on-premises instances that make up the VPE platform.

    Downloading the VPE Image

    First, you must download the VPE image from the Netskope UI. Note that the time it takes to download the image depends on the network speed between your environment and the Netskope Management Plane (MP).

    To download the image:

    1. Go to Settings > Security Cloud Platform > On-Premises Infrastructure.
    2. Click the Next-Gen tab.
    3. On the Next-Gen page, click Download Image.
    4. In the Get VM Image window, download the appropriate image.

    Deploying the VPE Image

    After downloading the image, deploy the VPE Node in your environment with standard hypervisor deployment steps. For examples of similar instructions, see Install the Virtual Appliance on VMware ESX 6.5 or Later or Install the Virtual Appliance on Linux KVM.

    Registering the VPE Node

    After you successfully deploy the VPE Node, you must configure and then register it in your Netskope tenant.

    Configuring the VPE Node

    To configure the VPE Node:

    1. Log in to the VPE CLI via SSH with the default username nsadmin and password nsappliance.
    2. Use the command show version-info to confirm that the software version of the VPE Node is correct.
    3. Use the command auth change-password nsadmin to update the default password. A password must have a minimum length of 14 characters and include at least one number, one uppercase letter, one lowercase letter, and one special character or symbol.
    4. You must set up the network interface for the VPE Node. Use the command configure to enter configuration mode.
    5. For DNS configuration, use the command set dns primary <Primary DNS Server IP>.
    6. The default interface (dp2) is used for management and the dataplane. You can use DHCP configuration for the dp2 interface. Use the command set interface dp2 v4 enable true to configure DHCP.
    7. (Optional) Alternatively, you can configure a static IP address for the dp2 interface instead.
      • If DHCP is already enabled, use the show route interface command to see the IP, gateway, and netmask assigned to the interface.
      • Before setting the static IP address, you must use the following command to disable DHCP: set interface dp2 v4 enable false.
      • Use the following commands to set the static IP:
        set interface dp2 v4 static ip <IP address>
        set interface dp2 v4 static netmask <netmask>
        set interface dp2 v4 static gw <gateway>
        set interface dp2 v4 static enable true
      • Netskope recommends updating the VPE Node hostname for local identification. For example, the Netskope UI displays this hostname during the registration process. Use the following command to update the hostname: set system hostname <new hostname>.

    Creating a Registration Token

    After you configure the VPE Node, you must create a one-time registration token for VPE in the Netskope UI.

    1. Go to Settings > Security Cloud Platform > On-Premises Infrastructure.
    2. Click the Next-Gen tab.
    3. On the Next-Gen page, click Registration Tokens.
    4. In the Registered Tokens window, click Create Token and then the number of tokens you wish to create. You can create up to 10 tokens at a time.
    5. Hover over the token you created and then click Copy or Download.

    Saving the Registration Token

    After creating the token, return to the VPE CLI to save and pair it with the VPE Node, completing the registration process. Use the following command to save the token: set system registrationkey <token>.

    Note

    The registration process can take up to 20 minutes to complete, depending on network latency.

    Verifying VPE Node Registration

    You can verify the success of the VPE Node registration from the Netskope UI and the VPE CLI. In the Netskope UI, the VPE Node is displayed on the Next-Gen page with the VPE Node hostname and serial number.
    In the VPE CLI, use the command status tethering to verify the VPE Node serial number.

    In this Topic
    • Deploying Virtual Private Edge