How to Create a vSwitch with an Uplink Interface via CLI in Hyperion

Written By Christian Castagna (Administrator)

Updated at February 5th, 2026

→ Applies to: Hyperion 9.x and above

PREREQUISITES
Ensure the appliance is running SynetoOS 6.0.1 or later

All commands in this article are intended to be executed via Hyperion CLI.

 

Step 1. Connect to Hyperion appliance via SSH as admin

ssh admin@<your_ip_address_or_hostname>

 

Step 2. Become Super User

sudo su

 

Step 3. Create a new vSwitch with a uplink interface (replace <vswitch_name> and <interface> with the correct information)

syneto-nmctl vswitch create --name <vswitch_name> --uplink <interface> 

EXAMPLE

syneto-nmctl vswitch create --name vswitch1 --uplink ens256

 

Step 4 (optional). Add an additional uplink to a vSwitch ("How to Add an Additional Uplink to a vSwitch via CLI in Hyperion")