Skip to navigationSkip to content
libvirtd docs
Commands

Manual nav

Search `/` or jump with `g` / `G`.

Portal

  • Home manual
  • Command explorer
Foundations6 sections
  • Overview1
  • Installation2
  • Platform1
  • Concepts5
  • Domains2
  • Domain XML2
Subsystems9 sections
  • Identity1
  • Automation2
  • Daemons3
  • virsh3
  • Networking5
  • Storage4
  • Security3
  • Observability2
  • Remote Access1
Operations6 sections
  • Migration2
  • Backup2
  • Performance3
  • Recovery1
  • Troubleshooting2
  • References2

/ search · g top · G quickstart

mannetworkingReviewed July 15, 2026

Bridge design and host uplinks

A Linux bridge is a layer 2 switch in the host. The host address belongs on the bridge, while the physical interface becomes a port of that bridge. Inspect without changing NetworkManager pattern Move the host IP configu

bridgenetworkmanageruplinkvlan

A Linux bridge is a layer-2 switch in the host. The host address belongs on the bridge, while the physical interface becomes a port of that bridge.

Inspect without changing

BASH
ip -br link
ip -br address
bridge link
bridge vlan show
nmcli -f NAME,TYPE,DEVICE,STATE connection show

NetworkManager pattern

BASH
nmcli connection add type bridge ifname br0 con-name br0
nmcli connection add type ethernet ifname eno1 master br0 con-name br0-port-eno1

Move the host IP configuration to br0 before activating the new topology. Remote changes can sever management connectivity; use console access, a maintenance window, and an explicit rollback connection profile.

Guest attachment proof

BASH
virsh domiflist guest01
ip link show master br0
bridge fdb show br br0

Do not run host DHCP on a bridge when the upstream network already owns address assignment unless the segments are intentionally isolated.

Related

  • DHCP, DNS, and libvirt virtual networks
  • Libvirt network modes
  • Network debugging for guests

On this page

  • Inspect without changing
  • NetworkManager pattern
  • Guest attachment proof