Setting a Static IP Address for the TrueNAS UI
4 minute read.
Last Modified 2022-05-13 13:10 EDTDisruptive Change
Making changes to the network interface the web interface uses can result in losing connection to the TrueNAS system! Fixing any misconfigured network settings might require command line knowledge or physical access to the TrueNAS system.
TrueNAS can configure physical network interfaces with static IP addresses in either the web interface or the system console menu.
Using the web interface for this process is recommended. There are additional safety features to prevent saving misconfigured interface settings.
Log in to the web interface and go to Network > Interfaces. This contains creation and configuration options for physical and virtual network interfaces.
You can configure static IP addresses while creating or editing an interface.
High Availability must be disabled on TrueNAS Enterprise systems before you can edit an active interface.
Type the desired address in the IP Address field and select a subnet mask.
Multiple interfaces cannot be members of the same subnet. See Multiple network interfaces on a single subnet for more information. Check the subnet if an error is shown when setting the IP addresses on multiple interfaces.
Use the buttons to Add and Delete more IP addresses as needed.
To avoid permanently saving invalid or unusable settings, network changes are applied temporarily. Saving any interface changes adds a dialog to the Network > Interfaces list to apply these changes.
You can adjust how long to test the network changes before they are reverted back to the previous settings. If the test is successful, another dialog allows making the network changes permanent.
To quickly view system networking settings, go to Network > Network Summary.
A monitor and keyboard attached to the system is needed to use the console, or, if the system hardware allows it, you can connect with IPMI. The console menu displays after the system is fully booted.
Use the Configure Network Interfaces option to add static IP addresses to a physical interface. Other interface types have a similar process to add static IP addresses. Interfaces that are already configured for DHCP have that option disabled. There are a number of prompts to answer before you can add a static address. This example shows adding static IPv4 addresses to interface igb0:
Saving interface configuration changes disrupts the web interface while system networking restarts. When the interface you are changing is also the interface that provides the web interface, a system reboot might be required for the new settings to take effect and the web interface to become available again.