How to create a vSwitch with an uplink interface via CLI in Hyperion

Written By Christian Castagna (Administrator)

Updated at September 15th, 2025

→ Applies to: Hyperion 9.x and above

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 (optional). Install the package

rpm -ivh https://storage.googleapis.com/syneto_public_files/downloads/Syneto-Tools/Networking/syneto-nmctl-0.5.0-1.el9.x86_64.rpm

If the package is already installed, you do not need to run this command.

 

Step 4. 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 

EXAMPLE OUTPUT

[+] Creating bridge 'vswitch1' with label 'vswitch1' and uplink 'ens256'
Connection 'vswitch1' (73ef8751-d27d-4813-8a54-eaafe55817b4) successfully added.
Error: unknown connection 'vswitch1 Uplink'. <--IGNORE
Error: cannot delete unknown connection(s): 'vswitch1 Uplink'. <--IGNORE
[+] Configuring 'ens256' as direct bridge uplink
Connection 'vswitch1 Uplink' (a5b743ab-48e9-4fdd-88bd-cd1764850421) successfully added.
Connection successfully activated (controller waiting for ports) (D-Bus active path: /org/freedesktop/NetworkManager/ActiveConnection/20)
Connection successfully activated (D-Bus active path: /org/freedesktop/NetworkManager/ActiveConnection/22)

 

Step 5 (optional). Add an additional uplink to a vSwitch ("How to add an additional uplink to a vSwitch via CLI in Hyperion")