How to Configure Network Bridge in Ubuntu

Linux supports the implementation of a software network bridge to reproduce the function of a network bridge, a networking device that interconnects two or more communication networks or network segments providing a way for them to work as a single network. It acts almost like a network switch, and in a software sense, it is used to implement the concept of a “virtual network switch”.

A typical use case of software network bridging is in a virtualization environment to connect virtual machines (VMs) directly to the host server network. This way, the VMs are deployed on the same subnet as the host and can access services such as DHCP and much more.

In this article, you will learn different ways to set up a network bridge in Ubuntu and use it within a virtualization environment to create virtual networking in a bridged mode under VirtualBox and KVM, to connect Virtual Machines to the same network as the host.

Installing Network Bridge Utilities in Ubuntu

Begin by installing the bridge-utils package which contains utilities for configuring the Ubuntu ethernet bridge using the apt package manager as shown.

$ apt-get install bridge-utils

Next, identify the interface name for your ethernet device using the IP command as shown.

$ ip ad
OR
$ ip add
Check Network Interfaces in Ubuntu

Check Network Interfaces in Ubuntu

Creating a Network Bridge Using NetPlan in Ubuntu

Netplan is a simple and easy-to-use front-end utility for configuring networking in Linux using the YAML format. It currently supports NetworkManager and systemd-netword as backend tools.

To configure networking for an interface such as a bridge, edit your netplan configuration file found in /etc/netplan/ directory.

The following is an example configuration file, where the renderer is systemd-netword which is the default (replace enp1s0 with your ethernet interface name).

network:
  version: 2
  renderer: networkd
  ethernets:
    enp1s0:
      dhcp4: no
  bridges:
    br0:
      dhcp4: yes
      interfaces:
	     - enp1s0
Netplan Configuration File

Netplan Configuration File

Save the configuration file and apply the configuration to enable the bridge network by running the following command.

$ sudo netplan apply

Then use the brctl command to show all bridges on the system. In this case, the Ethernet interface is automatically added as a port to the bridge.

$ sudo brctl show
Show Network Bridges

Show Network Bridges

If you want to bring down or deactivate the created network bridge, then delete it using the following commands.

$ sudo ip link set enp1s0 up
$ sudo ip link set br0 down
$ sudo brctl delbr br0
OR
$ sudo nmcli conn up Wired\ connection\ 1
$ sudo nmcli conn down br0
$ sudo nmcli conn del br0
$ sudo nmcli conn del bridge-br0

Creating a Network Bridge Using Nmcli in Ubuntu

nmcli is a widely-used network manager command-line tool to administer NetworkManager (create, show, edit, delete, activate, and deactivate network connections) and displaying network device status.

To create a network bridge using nmcli, run the following command.

$ sudo nmcli conn add type bridge con-name br0 ifname br0
Create a Network Bridge Using nmcli Tool

Create a Network Bridge Using nmcli Tool

Then add the Ethernet interface as a port in the bridge as shown (remember to replace enp1s0 with your device name).

$ sudo nmcli conn add type ethernet slave-type bridge con-name bridge-br0 ifname enp1s0 master br0
Add a Network Bridge Ports

Add a Network Bridge Ports

Next, confirm that the bridge has been created by showing all network connections.

$ sudo nmcli conn show --active
Verify Network Bridge

Verify Network Bridge

Next, activate the bridge connection as follows (you can use either the connection/interface name or the UUID).

$ sudo nmcli conn up br0
OR
$ sudo nmcli conn up e7385b2d-0e93-4a8e-b9a0-5793e5a1fda3
Activate Bridge Network Connection

Activate Bridge Network Connection

Then deactivate the Ethernet interface or connection.

$ sudo nmcli conn down Ethernet\ connection\ 1
OR
$ sudo nmcli conn down 525284a9-60d9-4396-a1c1-a37914d43eff
Deactivate Ethernet Connection

Deactivate Ethernet Connection

Now try to view active connections once more, the Ethernet interface should now be a slave in the bridge connection as shown in the following screenshot.

$ sudo nmcli conn show --active
Check Active Network Connections

Check Active Network Connections

Creating a Network Bridge Using nm-connection-editor Tool

To open the nm-connection-editor application, run the following command from the terminal.

$ nm-connection-editor

From the network connections editor window, click on the + sign to add a new connection profile.

Add a New Network Connection

Add a New Network Connection

Next, choose the connection type as Bridge from the drop-down and click Create.

Select Network Connection Type

Select Network Connection Type

Next, set the bridge connection name and the interface name.

Set Bridge Connection Name

Set Bridge Connection Name

Then click the Add button to add the bridge slave ports i.e the Ethernet interface as shown in the following screenshot. Select Ethernet as the connection type and click Create.

Add a Network Bridge Connection

Add a Network Bridge Connection

Next, set the connection name according to your preference and click Save.

Set New Bridge Connection Name

Set New Bridge Connection Name

Under bridged connections, the new connection should now appear.

Verify New Bridge Connection

Verify New Bridge Connection

Now if you open the network connection editor once more, the new bridge interface and the slave interface should exist as indicated in the following screenshot.

Check Network Bridge Connection

Check Network Bridge Connection

Next, activate the bridge interface and deactivate the Ethernet interface, using the nmcli command.

$ sudo nmcli conn up br0
$ sudo nmcli conn down Ethernet\ connection\ 1

How to Use a Network Bridge in a Virtualization Software

After setting up a network bridge (virtual network switch), you can use it in a virtualization environment such as Oracle VirtualBox and KVM to connect VMs to the host network.

Using a Network Bridge in Oracle VirtualBox

Open VirtualBox, then from the list of VMs, select a VM, then click on its settings. From the settings window, go to the Network option and select an adapter (e.g Adapter 1).

Then check the option Enable Network Adapter, set the value of the attached to the field to Bridged Adapter, then set the Name of the bridged interface (e.g br0) as indicated in the following screenshot. Then click Ok.

Configure VM to Use Bridge Network in VirtualBox

Configure VM to Use Bridge Network in VirtualBox

Using a Network Bridge in KVM

You can use the new network bridge under KVM by adding the --network=bridge=br0 option while creating a new virtual machine, using the virt-install command.

# virt-install --virt-type=kvm --name Ubuntu18.04 --ram 1536 --vcpus=4 --os-variant=ubuntu18.04 --cdrom=/path/to/install.iso --network=bridge=br0,model=virtio --graphics vnc --disk path=/var/lib/libvirt/images/ubuntu18.04.qcow2,size=20,bus=virtio,format=qcow2

From the web console, it will be select automatically. Besides, you can also configure a network bridge using the virsh command-line tool, and a VM’s XML configuration file.

For more details, read the netplan and nmcli man pages (by running man netplan and man nmcli) as well as virtual networking in libvirt and virtual networking in VirtualBox. You can post any queries to us via the comment section below.

If You Appreciate What We Do Here On TecMint, You Should Consider:

TecMint is the fastest growing and most trusted community site for any kind of Linux Articles, Guides and Books on the web. Millions of people visit TecMint! to search or browse the thousands of published articles available FREELY to all.

If you like what you are reading, please consider buying us a coffee ( or 2 ) as a token of appreciation.

Support Us

We are thankful for your never ending support.

Aaron Kili

Aaron Kili is a Linux and F.O.S.S enthusiast, an upcoming Linux SysAdmin, web developer, and currently a content creator for TecMint who loves working with computers and strongly believes in sharing knowledge.

Your name can also be listed here. Got a tip? Submit it here to become an TecMint author.

RedHat RHCE and RHCSA Certification Book
Linux Foundation LFCS and LFCE Certification Preparation Guide
The Complete Linux System Administrator Bundle
Become an Ethical Hacker Bonus Bundle

You may also like...

4 Responses

  1. Bob says:

    I just installed KVM/emu and virt-manager on the arch. During the creation of a virtual machine, the installer automatically configured my network bridge.

    • Aaron Kili says:

      @Bob

      Yes, there is a default network bridge under KVM, but it is configured to run in NAT mode if I am not mistaken. This may not allow your VM to be accessible from the LAN.

  2. Stephen hemminger says:

    As iproute2 maintainer, and former maintainer of Linux bridge, thank you for the article.

    Bridge utils like ifconfig is a legacy command; and therefore receives no updates.

    Please use the new bridge utility which is part of iproute2

Got something to say? Join the discussion.

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.