(408) 943-4100               V   Commercial Support Toggle between Light and Dark mode

Editing a Physical Interface

  3 minute read.

Last Modified 2021-04-01 13:14 EDT

Interface Editing

Be careful when configuring the network interface that controls the TrueNAS® web interface or you may lose web connectivity.

Network > Interfaces lists all the physical Network Interface Controllers (NICs) connected to your TrueNAS® system.


To edit an interface, click > next to it to expand the view and provide a general description about the chosen interface, then click EDIT.

If you are a TrueNAS Enterprise customer, remember that you cannot edit an interface if High Availability (HA) is enabled.
Go to System > Failover and check the Disable Failover box, then click SAVE.


An interface’s editing options are dependent on the Type of interface that you are modifying.

Interface Settings

DescriptionstringNotes or explanatory text about this interface.
DHCPcheckboxEnable DHCP to auto-assign an IPv4 address to this interface. Leave unset to create a static IPv4 or IPv6 configuration. Only one interface can be configured for DHCP.
Autoconfigure IPv6checkboxAutomatically configure the IPv6 address with rtsol. Only one interface can be configured this way.

Other Settings

Disable Hardware OffloadingcheckboxTurn off hardware offloading for network traffic processing. WARNING: disabling hardware offloading can reduce network performance and is only recommended when the interface is managing jails, plugins, or virtual machines (VMs).
MTUstringMaximum Transmission Unit, the largest protocol data unit that can be communicated. The largest workable MTU size varies with network interfaces and equipment. 1500 and 9000 are standard Ethernet MTU sizes. Leaving blank restores the field to the default value of 1500.
OptionsstringAdditional parameters from ifconfig. Separate multiple parameters with a space. For example: mtu 9000 increases the MTU for interfaces which support jumbo frames.

IP Addresses

IP Addressinteger and drop-down menuStatic IPv4 or IPv6 address and subnet mask. Example: and /24. Click ADD to add another IP address. Clicking DELETE removes that IP Address.

Saving Changes

After you’re done editing, click SAVE. You have the option to TEST CHANGES or REVERT CHANGES. The default time for testing any changes is 60 seconds, but you can change it to your desired setting.


After clicking TEST CHANGES, confirm your choice and click TEST CHANGES again.


Users can either SAVE CHANGES or REVERT CHANGES. A user will have the time they specified to make their choice. If you select SAVE CHANGES, a dialog box will ask you to CANCEL or SAVE network interface changes. Click SAVE.



The system will display a dialog box to show that Network interface changes have been made permanent.