How to Create a VLAN via CLI in Hyperion

Written By Christian Castagna (Super Administrator)

Updated at April 30th, 2026

Table of Contents

→ Applies to: Hyperion 9.x and above

PREREQUISITES
– Ensure the appliance is running SynetoOS 6.0.1 or later
– Ensure the appliance is running Syneto-nmctl version 2.0.0 (b43108a) or later. For upgrade instructions, refer to (“How to Upgrade Syneto-nmctl 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. 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 ---

 

Step 4. Create a new VLAN network (replace <vlan_id_number> and <vswitch_name> with the correct information)

syneto-nmctl vlan create --vlan-id <vlan_id_number> --vswitch <vswitch_name>

EXAMPLE

syneto-nmctl vlan create --vlan-id <number> --vswitch vlan

 

Step 5. Create a new virtual network for a VLAN (replace <network_name> and <vlan_id_number> with the correct information)

syneto-nmctl network create --name <network_name> --vlan-id <vlan_id_number>

EXAMPLE

syneto-nmctl network create --name VLAN200 --vlan-id 200

 

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

 

Video Example