Get a Quote     (408) 943-4100               TrueNAS Discord      VendOp_Icon_15x15px   Commercial Support Toggle between Light and Dark mode

Managing Interfaces

  3 minute read.

Last Modified 2022-07-26 09:16 EDT

You can add new or edit existing network interfaces on the Network screen.

LAGG (Link Aggregation)

You should use LAGG if you want to optimize multi-user performance, balance network traffic, or have network failover protection.

For example, Failover LAGG prevents a network outage by dynamically reassigning traffic to another interface when one physical link (a cable or NIC) fails.

Network Bridge

You should use a Bridge if you want to enable communication between two networks and provide a way for them to work as a single network.

For example, bridges can serve IPs to multiple VMs on one interface, which allows your VMs to be on the same network as the host.

Adding an Interface

You can only use DHCP to provide the IP address for one network interface and this is most likely for your primary network interface configured during the installation process.

To add another network interface leave the DHCP checkbox clear and click the Add button near the bottom of the Add Interface configuration panel so you can enter a static IP address for the interface.

Click Add on the Interfaces widget to display the Add Interface panel.

You must specify the type of interface you want to create. The Type field provides three options: Bridge, Link Aggregation or LAGG, and VLAN* or virtual LAN. You cannot edit the interface type after you click **Save**.

Each interface type displays new fields on the Add Interface panel. Links with more information on adding these specific types of interfaces are at the bottom of this article.

Editing an Interface

Click on an existing interface in the Interfaces widget to display the Edit Interface configuration panel. The fields on the Edit Interface and Add Interface configuration panel fields are identical except for the Type and Name fields. Both of these fields are editable only on the Add Interface panel before you click Save. The Type field only appears on the Add Interface configuration panel.

Because you cannot edit the interface type or name after you click Save, if you make a mistake with either field you can only delete that interface and create a new one with the desired type.

If you want to change from DHCP to a static IP, you must also add the new default gateway and DNS nameservers that work with the new IP address. See Setting Up a Static IP for more information.

If you delete the primary network interface you can lose your TrueNAS connection and the ability to communicate with the TrueNAS through the web interface!

You might need command line knowledge or physical access to the TrueNAS system to fix misconfigured network settings.

Deleting an Interface

Click the icon next to the interface. The delete interface confirmation dialog displays.

Do not delete the primary network interface!

If you delete the primary network interface you lose your TrueNAS connection and the ability to communicate with the TrueNAS through the web interface! You might need command line knowledge or physical access to the TrueNAS system to fix misconfigured network settings.

Related Content