How to create a VLAN on a vSwitch via CLI in Hyperion

Written By Christian Castagna (Administrator)

Updated at September 3rd, 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.4.4-1.el9.x86_64.rpm

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

 

Step 4 (optional). Create a new vSwitch

Create a new vSwitch based on your desired configuration

 

Step 5. List all vSwitches

syneto-nmctl vswitch list

EXAMPLE

syneto-nmctl vswitch list

=== Virtual Switches ===
--- General purpose Virtual Switches ---
Management Network        vswitch0     bridge   activated
  └─ em2 (Management Uplink)
cni0                      cni0         bridge   activated
virbr0                    virbr0       bridge   activated

--- VLAN-Dedicated Virtual Switches ---

Make note of the vSwitch on which the VLAN is to be configured

 

Step 6. Create a new VLAN network (replace <vlan_name>, <vlan_id> and <vswitch_name> with the correct information)

syneto-nmctl vlan create --name "<vlan_name>" --vlan-id <vlan_id> --vswitch <vswitch_name>

EXAMPLE

syneto-nmctl vlan create --name "VLAN 3003" --vlan-id 3003 --vswitch vswitch1

 

Step 7. Assign VLAN to an Hyperion VM ("How to assign a VLAN to an Hyperion VM")