How to Create Two vSwitches in Hyperion

Written By Christian Castagna (Administrator)

Updated at January 19th, 2026

→ Applies to: Hyperion 9.x and above

This article lists the steps to create two vSwitches, one for untagged traffic and one for VLAN traffic in Hyperion.

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. Mark the default vSwitch as master (replace <vswitch_name> with the correct vSwitch)

syneto-nmctl vswitch set-master --name <vswitch_name>
syneto-nmctl vswitch set-master --name vswitch0

 

Step 4. Create a vSwitch for untagged traffic (replace <vswitch_untagged_name> with the correct vSwitch untagged)

syneto-nmctl vswitch create --name <vswitch_untagged_name> --uplink none

EXAMPLE

syneto-nmctl vswitch create --name untagged --uplink none

 

Step 5. Connect the vSwitch from Step 4 to the default vSwitch from Step 3 (replace <vswitch_untagged_name> with the correct untagged vSwitch and <vswitch_name> with the correct vSwitch)

syneto-nmctl vswitch connect --bridge <vswitch_untagged_name> --to <vswitch_name>

EXAMPLE

syneto-nmctl vswitch connect --bridge untagged --to vswitch0

 

Step 6. Create a vSwitch for VLAN traffic (replace <vswitch_vlan_name> with the correct vSwitch vlan)

syneto-nmctl vswitch create --name <vswitch_vlan_name> --uplink none

EXAMPLE

syneto-nmctl vswitch create --name vlan --uplink none

 

Step 7. Connect the vSwitch from Step 6 to the default vSwitch (replace <vswitch_vlan_name> with the correct vSwitch vlan and <vswitch_name> with the correct vSwitch from Step 3)

syneto-nmctl vswitch connect --bridge <vswitch_vlan_name> --to <vswitch_name>

EXAMPLE

syneto-nmctl vswitch connect --bridge vlan --to vswitch0

 

Step 8. Connect the VM Network to the vSwitch for untagged traffic from Step 4 (replace <virtual_network_name> with the correct virtual network name and <vswitch_untagged_name> with the correct vSwitch untagged)

syneto-nmctl network change —-name <virtual_network_name> --vswitch <vswitch_untagged_name>

EXAMPLE

syneto-nmctl network change —-name VM\ Network --vswitch untagged