FRG: Network

Descriptions of each field in the Network section of the TrueNAS web interface.

  4 minute read

Global Configuration

Hostname and Domain

HostnameSystem hostname.
DomainSystem domain name, like
Additional DomainsAdditional domains to search. Separate entries by pressing Enter. Adding search domains can cause slow DNS lookups.

DNS Servers

NameServer 1Primary DNS server.
NameServer 2Secondary DNS server.
NameServer 3Third DNS server.

Other Settings

HTTP ProxyWhen using a proxy, enter the proxy information for the network in the format http://my.proxy.server:3128 or http://user:password@my.proxy.server:3128
Enabled Netwait FeaturesDelays the start of network services until pings are returned from the IP addresses added to the Netwait IP List.
Host Name DatabaseAdditional hosts to be appended to /etc/hosts. Separate entries by pressing Enter. Hosts defined here are still accessible by name even when DNS is not available. See hosts(5) for additional information.
Service Announcement
NetBIOS-NSLegacy NetBIOS name server. Advertises the SMB service NetBIOS Name. Can be required for legacy SMB1 clients to discover the server. When advertised, the server appears in Network Neighborhood).
mDNSMulticast DNS. Uses the system Hostname to advertise enabled and running services. For example, this controls if the server appears under Network on MacOS clients.
WS-DiscoveryUses the SMB Service NetBIOS Name to advertise the server to WS-Discovery clients. This causes the computer appear in the Network Neighborhood of modern Windows OSes.
Default Gateway
IPv4 Default GatewayEnter an IPv4 address. This overrides the default gateway provided by DHCP.
IPv6 Default GatewayEnter an IPv6 address. This overrides the default gateway provided by DHCP.


Interface Settings

TypeChoose the type of interface. Bridge creates a logical link between multiple networks. Link Aggregation combines multiple network connections into a single interface. A Virtual LAN (VLAN) partitions and isolates a segment of the connection. Read-only when editing an interface.
NameEnter a name for the interface. Use the format laggX, vlanX, or bridgeX where X is a number representing a non-parent interface. Read-only when editing an interface.
DescriptionEnter a description of the interface.
DHCPSet to enable DHCP. Leave unset to create a static IPv4 or IPv6 configuration. Only one interface can be configured for DHCP.
Autoconfigure IPv6Set to automatically configure the IPv6 address with rtsol(8). Only one interface can be configured this way.

Bridge Settings

Bridge MembersNetwork interfaces to include in the bridge.

LAGG Settings

Lagg ProtocolDetermines the outgoing and incoming traffic ports. LACP is the recommended protocol if the network switch is capable of active LACP. Failover is the default protocol choice and should only be used if the network switch does not support active LACP. See lagg(4) for more details.
Lagg InterfacesSelect the interfaces to use in the aggregation. Warning: Lagg creation fails if any of the selected interfaces have been manually configured.

VLAN Settings

Parent InterfaceSelect the VLAN Parent Interface. Usually an Ethernet card connected to a switch port configured for the VLAN. New link aggregations are not available until the system is restarted.
Vlan TagEnter the numeric tag configured in the switched network.
Priority Code PointSelect the Class of Service. The available 802.1p Class of Service ranges from Best effort (default) to Network control (highest).

Other Settings

Disable Hardware OffloadingTurn off hardware offloading for network traffic processing. WARNING: disabling hardware offloading can reduce network performance. Disabling hardware offloading is only recommended when the interface is managing jails, plugins, or virtual machines.
MTUMaximum 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, however the permissable range of values is 1492 to 9216. Leaving blank restores the field to the default value of 1500.
OptionsEnter additional parameters from ifconfig(8).

IP Addresses

IP AddressDefine an alias for the interface on this TrueNAS controller. The alias can be an IPv4 or IPv6 address.

Static Routes: Add

General Options

DestinationUse the format A.B.C.D/E where E is the CIDR mask.
GatewayEnter the IP address of the gateway.
DescriptionEnter a description of the static route.


IPMI Configuration

DHCPUse DHCP. Unset to manually configure a static IPv4 connection.
IPv4 AddressStatic IPv4 address of the IPMI web interface.
IPv4 NetmaskSubnet mask of the IPv4 address.
IPv4 Default GatewayEnter the default gateway of the IPv4 connection.
VLAN IDIf the IPMI out-of-band management interface is on a different VLAN from the management network, enter the IPMI VLAN.

IPMI Password Reset

PasswordEnter the password used to connect to the IPMI interface from a web browser.

Last modified January 29, 2021: Update (806e7f02)