On August 11, 2023, Cisco announced that Cisco SecureX will go end-of-life on July 31, 2024. The content in this Github repository will not be actively maintained following this announcement.

Creating a Remote

The first step to setting up an orchestration remote is to create it in your SecureX orchestration instance. This gives you the configuration necessary to deploy the virtual appliance.

Remote Overview

Note that the virutal machine's configuration cannot be easily modified after it is deployed. You can SSH or console into the Ubuntu host operating system, however, we do not support or document how to make configuration changes to the VM directly (with the exception of configuring NTP servers).

To create a new remote:

  1. Expand the main menu, click on Admin and then click on Remote Configuration.
  2. Click the New Remote button:

  3. Provide the remote a meaningful Display Name:

  4. Under the remote details section, select whether you want to use DHCP or a Static IP address for the virtual machine.
    • If using a Static IP, provide the:
      • IP address in CIDR notation (ex:
      • List of DNS servers (ex:,
      • Default gateway (ex:
  5. If a proxy is required for the remote to access the internet, set Requires Proxy to yes and provide the proxy address (only SOCKS5 proxies are supported).
  6. Click Submit.

Configuration Download

Now that the remote is created in orchestration, you can download the virtual machine configuration:

  1. Hover over the new remote you just created on the Remotes page.
  2. Click the arrow button in the Actions column on the right:

  3. Click Connect and then click the Generate Package button:

  4. A ZIP file with the remote’s configuration will be downloaded.

Next Steps

Now that you’ve created the remote in orchestration and downloaded the configuration bundle, you can proceed to virtual appliance setup.

Virtual Appliance Setup