SysTutorials

Cannot Start VM: Missing Default Network

· Weiwei Jia · updated April 12, 2026

After a libvirt upgrade, VMs fail to start with the error:

error: Failed to start domain kvm1
error: Network not found: no network with matching name 'default'

This happens when the default NAT network (virbr0) isn’t automatically created during the upgrade.

Quick fix: Restore the default network

The fastest solution is to recreate the default network definition. If you have another libvirt host with a working default network, dump its config:

sudo virsh net-dumpxml default > default.xml

On the affected host, edit default.xml and remove the <uuid> element — libvirt will generate a new one:

<network>
  <name>default</name>
  <forward mode='nat'>
    <nat>
      <port start='1024' end='65535'/>
    </nat>
  </forward>
  <bridge name='virbr0' stp='on' delay='0'/>
  <ip address='192.168.122.1' netmask='255.255.255.0'>
    <dhcp>
      <range start='192.168.122.2' end='192.168.122.254'/>
    </dhcp>
  </ip>
</network>

Create the network:

sudo virsh net-create default.xml

Verify it’s active:

sudo virsh net-list

If you don’t have a reference config

You can generate a minimal default network without a template. Use the standard libvirt defaults (192.168.122.0/24 with NAT):

cat > default.xml << 'EOF'
<network>
  <name>default</name>
  <forward mode='nat'/>
  <bridge name='virbr0' stp='on' delay='0'/>
  <ip address='192.168.122.1' netmask='255.255.255.0'>
    <dhcp>
      <range start='192.168.122.2' end='192.168.122.254'/>
    </dhcp>
  </ip>
</network>
EOF

sudo virsh net-create default.xml

Firewall backend errors

If you encounter:

error: Failed to create network from default.xml
error: internal error: Failed to initialize a valid firewall backend

This occurs when libvirt can’t find a firewall backend. Install the required dependencies:

sudo apt-get update
sudo apt-get install firewalld ebtables iptables

Then restart libvirtd:

sudo systemctl restart libvirtd

(On older systems using init.d, replace the above with sudo /etc/init.d/libvirt-bin restart)

Making the network persistent

The virsh net-create command creates a transient network that disappears on reboot. To make it permanent, use virsh net-define:

sudo virsh net-define default.xml
sudo virsh net-start default
sudo virsh net-autostart default

Verify it’s persistent:

sudo virsh net-list --all

The output should show default with Persistent set to yes.

Verify VM connectivity

Once the default network is running, start your VM and confirm it can reach the host:

sudo virsh start kvm1
sudo virsh console kvm1
# Inside the VM:
ip route
ping 192.168.122.1

Network Diagnostic Commands

When troubleshooting network connectivity:

Quick Reference

This article covered the essential concepts and commands for the topic. For more information, consult the official documentation or manual pages. The key takeaway is to understand the fundamentals before applying advanced configurations.

Practice in a test environment before making changes on production systems. Keep notes of what works and what does not for future reference.

2026 Best Practices and Advanced Techniques

For Cannot Start VM: Missing Default Network, understanding both the fundamentals and modern practices ensures you can work efficiently and avoid common pitfalls. This guide extends the core article with practical advice for 2026 workflows.

Troubleshooting and Debugging

When issues arise, a systematic approach saves time. Start by checking logs for error messages or warnings. Test individual components in isolation before integrating them. Use verbose modes and debug flags to gather more information when standard output is not enough to diagnose the problem.

Performance Optimization

Security Considerations

Security should be built into workflows from the start. Use strong authentication methods, encrypt sensitive data in transit, and follow the principle of least privilege for access controls. Regular security audits and penetration testing help maintain system integrity.

These complementary tools expand your capabilities:

Integration with Modern Workflows

Consider automation and containerization for consistency across environments. Infrastructure as code tools enable reproducible deployments. CI/CD pipelines automate testing and deployment, reducing human error and speeding up delivery cycles.

Quick Reference

This extended guide covers the topic beyond the original article scope. For specialized needs, refer to official documentation or community resources. Practice in test environments before production deployment.

← All posts