Setting a Static IP Address

How to set a static IP address in either the web interface or system console.

  4 minute read

Process Summary

  • Web UI
    • Network > Interfaces > Add or Edit
      • Type address into IP Address and select subnet mask.
      • Add or Delete additional addresses as needed.
    • Test saved changes before permanently applying them.
      • Dialog asks to temporarily apply changes.
      • After applying the changes, you have an adjustable amount of time to verify the new settings work before permanently saving over the previous configuration.
    • Network > Network Summary summarizes addressing information of every configured interface.
  • Console menu
    • Physical Interfaces: select Configure Network Interfaces (options are similar for other interface types)
      • Delete interface? n
      • Remove interface settings? n
      • Configure IPv4? y
        • Enter IP address and subnet mask
      • Configure IPv6 y
        • Enter IP address
      • Configure failover? n
    • Saving changes interrupts the web interface and could require a system reboot.

Setting Static IP Addresses

TrueNAS can configure physical network interfaces with static IP addresses in either the web interface or the system console menu. Using the web interface is recommended as that option has an additional safety feature to prevent saving misconfigured interface settings.

Adding Static IP Addresses Using the Web Interface

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.

Type the desired address in the IP Address field and select a subnet mask.

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

To avoid permanently saving invalid or unusable settings, network changes are applied temporary. 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 the Network Summary screen.

Using the System Console Menu to Assign Static IP Addresses to a Physical Interface

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 is shown when 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 were already configured for DHCP will have that option disabled. There are a number of prompts to answer before a static address can be added. 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:
  Example 2 IP and Netmask separate:
      Netmask:, /24 or 24
  IPv4 Address:
  Saving interface configuration: Ok
  Configure IPv6? (y/n) n
  Configure failover settings? (y/n) n
  Restarting network: ok
  Restarting routing: ok

Saving interface configuration changes will disrupt the web interface while system networking restarts. When the interface being changed is also the interface that provides the web interface, a system reboot could be required for the new settings to take effect and the web interface to become available again.

Last modified February 10, 2021: Update (6889a692)