Get a Quote     (408) 943-4100   TrueNAS Discord VendOp_Icon_15x15px Enterprise Support
TrueNAS.com Software Systems Company Community Security iX Portal Download
TrueNAS Enterprise TrueNAS SCALE TrueNAS CORE Compare Editions TrueCommand Software Status FreeNAS
Compare Systems F-Series M-Series H-Series R-Series Mini Series
Contact Us iXsystems Careers Clients Reviews
TrueNAS GitHub Community Forum Discord TrueNAS Merch Store
Use Cases Analytics Backup and Archival Cloud Data Mobility File Sharing iX Storj Media Creation Surveillance Virtualization
Industry Education Government Healthcare Research / AI / ML Media & Entertainment
Enterprise Support Community Support Documentation TrueNAS Security FAQ ZFS Overview
TrueNAS Blog Solution Guides Datasheets Case Studies Videos TrueCommand Cloud
Download TrueNAS SCALE Download TrueNAS CORE Get TrueNAS Enterprise Compare TrueNAS Editions Contact an Enterprise Specialist
  1. TrueNAS CORE
  2. /
  3. Configuration Tutorials
  4. /
  5. Network
  6. /
  7. Interfaces
  8. /
  9. Setting Up a Network Bridge
Edit page
TrueNAS CORETrueNAS CORE Version Documentation
This content follows the TrueNAS CORE 13.0 releases. Use the Product and Version selectors above to view content specific to different TrueNAS software or major version.

Setting Up a Network Bridge

  2 minute read.

A bridge generally refers to various methods of combining (aggregating) many network connections. These form a single total network. TrueNAS uses bridge(4) to manage bridges.

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

NetworkInterfaceAddBridgeScreen

Select Bridge as the Type and 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. Enter details about this particular bridge in Description.

The next section is Bridge Settings. Use the dropdown list next to Bridge Members to select the correct interfaces. Configure the remaining interface options to match your networking needs.

See Interfaces Screen for more information on settings.

Other Settings

Every kind of network interface has common settings:

NetworkInterfacesAddOtherSettings

Disabling Hardware Offloading can reduce network performance. It is not recommended.

Disabling this option is sometimes necessary. For example, when the interface is managing jails, plugins, or virtual machines.

MTU stands for maximum transmission unit. It is the largest protocol unit for transferring data. MTU size varies. Physical hardware and available network interfaces determine the largest workable MTU size. 1500 and 9000 are standard Ethernet MTU sizes. The recommendation is to use the default 1500. The permissible range of MTU values is 1492-9216. Leaving this field blank sets the default value of 1500.

You can enter more tuning ifconfig settings in the Options.

IP Addresses

Additional aliases for the interface can also be defined:

NetworkInterfacesAddIpAddresses

It is possible to define either IPv4 or IPv6 addresses and subnets from 1-32. Clicking Add provides another field for defining an IP address.

Related Content

Related Articles

    Have more questions or want to discuss your specific configuration? For further discussion or assistance, see these resources:

    Found content that needs an update? You can suggest content changes directly! To request changes to this content, click the Feedback button located on the middle-right side of the page (might require disabling ad blocking plugins).