Creating a Network Bridge

How to create a network Bridge on TrueNAS.

  2 minute read

A Bridge generally refers to various methods of combining (aggregating) multiple network connections into a single, aggregate network from multiple communication networks or network segments. TrueNAS uses bridge(4) to manage Bridges.

To set up a Bridge interface, go to Network > Interface > Add.



Set Type to Bridge.

Enter a name for the interface. The name must use the format, bridgeX, where X is a number representing a non-parent interface. It is also recommended to add any notes or reminders about this particular Bridge in the Description.

Under Bridge Settings, select which interfaces will be Bridge Members and then configure the remaining options to match your networking needs:

Disabling Hardware Offloading is discouraged as it can reduce network performance. Disabling this is only recommended when the interface is managing Jails, Plugins, or Virtual Machines.

The Maximum Transmission Unit (MTU) is the largest protocol data unit that can be communicated. What the largest workable MTU size can be will change according to your available network interfaces and other physical hardware. 1500 and 9000 are standard Ethernet MTU sizes and TrueNAS recommends leaving this at the default 1500. The permissable range of MTU values is 1492 to 9216. Leaving this field blank restores the field to the default value of 1500.

If additional tuning is needed, you can enter additional ifconfig settings in the Options

You can also define additional aliases for the Bridge interface. Either IPv4 or IPv6 interfaces can be defined.


Last modified February 9, 2021: DOCS-1613: PR review (8eda65d3)