Setting a Static IP Address for the TrueNAS UI

Disruptive Change

It is possible to make changes to the network interface that the web interface uses. But this can result in losing connection to the TrueNAS system! Very often fixing misconfigured network settings requires command line knowledge. Physical access to the system is often required as well.

TrueNAS can configure physical network interfaces with static IP addresses. Use either the web interface or the system console menu.

The recommendation is to use the web interface for this process. There are extra 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.

To edit an active interface on TrueNAS Enterprise systems, you must first disable High Availability.

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. If an error displays when setting the IP addresses on multiple interfaces, check the subnet.

Use the buttons to Add and Delete more IP addresses as needed.

To avoid saving invalid or unusable settings, network changes are at first temporary. Applying any interface changes adds a dialog to the Network > Interfaces list.

You can adjust how long to test the network changes before they revert back to the previous settings. If the test is successful, another dialog allows making the network changes permanent.

To view system networking settings, go to Network > Network Summary.

You need to have a monitor and keyboard attached to the system to use the console. If the system hardware allows it, you can connect with IPMI. The console menu displays after the system completes booting.

To add static IP addresses to a physical interface, go to Configure Network Interfaces. 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 many prompts to answer before you can add a static address. This example shows adding static IPv4 addresses to interface igb0:

  Enter an option from 1-11: 1
  1) igb0
  2) igb1
  Select an interface (q to quit): 1
  Delete interface? (y/n) n
  Remove the current settings of this interface? (This causes a momentary disconne
  ction of the network.) (y/n) n
  Configure IPv4? (y/n) y
  Interface name:
  Several input formats are supported
  Example 1 CIDR Notation:
      192.168.1.1/24
  Example 2 IP and Netmask separate:
      IP: 192.168.1.1
      Netmask: 255.255.255.0, /24 or 24
  IPv4 Address:10.238.15.194/22
  Saving interface configuration: Ok
  Configure IPv6? (y/n) n
  Configure failover settings? (y/n) n
  Restarting network: ok
  Restarting routing: ok

Related Content

• Interfaces Screen
• Network Summary
• Network Summary Screen
• Setting Up a Network Bridge
• Setting Up Link Aggregations
• Setting Up a Network VLAN
• Static Routes Screen
• Editing a Physical Interface
• IPMI Screen