How to Solve "Failed to Define Network" Error When Creating a Virtual Network in Hyperion

Written By Sebastian Sime (Draft Writer)

Updated at January 13th, 2026

Table of Contents

→ Applies to: Hyperion 9.x and above

 

Symptom

After creating a new virtual network connected to a vSwitch using the command:

syneto-nmctl network create --name "<network_name>" --vswitch <vswitch_name>

in some situations the operation may fail and return an error indicating that the network cannot be defined. This issue can occur during the creation of a new virtual network linked to an existing vSwitch and results in a Error: Libvirt command failed: Failed to define network

EXAMPLE OUTPUT

syneto-nmctl network create --name "Management Network" --vswitch vswitch0
[+] Creating libvirt network 'Management Network' on bridge 'vswitch0'
error: failed to connect to the hypervisor
error: Operation not supported: Cannot use direct socket mode if no URI is set. For more information see https://libvirt.org/kbase/failed_connection_after_install.html

Error: Libvirt command failed: Failed to define network

 

Solution


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. Start Hyperion services

systemctl start virtqemud
systemctl start virtnetworkd

 

Step 4. Create the virtual network (replace <network_name> and <vswitch_name> with the correct information)

syneto-nmctl network create --name "<network_name>" --vswitch <vswitch_name>

EXAMPLE

syneto-nmctl network create --name "Management Network" --vswitch vswitch0