Global Configuration Screens
4 minute read.
The Global Configuration widget displays the general TrueNAS networking settings not specific to any interface.
Use Settings to display the Global Configuration screen where you can add or change global network settings.
You can lose your TrueNAS connection if you change the network interface that the web interface uses! You might need command line knowledge or physical access to the TrueNAS system to fix misconfigured network settings.
Do not configure network settings to depend on any client container or application hosted on the TrueNAS system, such as DNS services, proxy networks, firewalls, and routers. This is an unsupported configuration because TrueNAS cannot access the necessary networks during boot if the client container has not started.
Many of these fields have default values, but users can change them to meet local network requirements.
TrueNAS displays the Hostname and Domain in the Dashboard System Information widget.
Some fields only display in the Global Configuration screen when the appropriate hardware is present.
| Setting | Description |
|---|---|
| Hostname | Sets the system host name. The default value is truenas. Some applications require setting this to a value other than truenas. |
| Inherit domain from DHCP | Sets the domain is inherited from DHCP when selected. |
| Hostname (TrueNAS Controller 2) | Sets the system host name for a second controller in High Availability (HA) systems where there is a second TrueNAS controller. A name can consist of upper and lower case alphanumeric and allowed special characters dot (.) and/or dash (-). |
| Hostname (Virtual) | Sets a virtual host name that shows when using a virtual host. Also used as the Kerberos principal name. Enter the fully qualified host name plus the domain name. A name can consist of upper and lower case alphanumeric and allowed special characters dot (.) and/or dash (-). |
| Domain | Enter a system domain name, for example, example.com. |
| Additional Domains | Specifies additional domains to search. Separate entries by pressing Enter. Adding search domains can cause slow DNS lookups. |
| Setting | Description |
|---|---|
| NetBIOS-NS | Sets using a legacy NetBIOS name server. Advertises the SMB service NetBIOS name. Might be required for legacy SMB1 clients to discover the server. When advertised, the server appears in Network Neighborhood. |
| mDNS | Sets the system to use multicast DNS. Uses the system host name to advertise enabled and running services. For example, this controls if the server appears under Network on MacOS clients. |
| WS-Discovery | Sets the system to use the SMB Service NetBIOS name to advertise the server to WS-Discovery clients. Can cause the computer to appear in the Network Neighborhood of modern Windows operating systems. |
| Setting | Description |
|---|---|
| Nameserver 1 | Sets the IP address for the primary DNS server. |
| Nameserver 2 | Sets the IP address for the secondary DNS server. |
| Nameserver 3 | Sets the IP address for the third DNS server. |
| Setting | Description |
|---|---|
| IPv4 Default Gateway | Sets the IPv4 address for the default gateway. This overrides the default gateway provided by DHCP. |
| IPv6 Default Gateway | Sets the IPv6 address for the default gateway of the IPv6 network. This overrides the default gateway provided by DHCP. |
Select the setting that matches your preferred system services allowed to communicate externally, HTTP proxy, and host name database preferences.
| Setting | Description |
|---|---|
| Allow All | Allow any system service to communicate externally. |
| Deny All | Restrict this system so it cannot communicate externally. |
| Allow Specific | Specifies a limited set of system services to allow to communicate externally. All other external traffic is restricted. If selected, a Services dropdown list shows where you select the services to allow to communicate externally. |
| Allow All Except | Allows all system services to communicate externally except for the services specified. If selected, a Services dropdown list shows where you select the services to deny external communication. |
| Setting | Description |
|---|---|
| HTTP Proxy | Specifies an HTTP proxy address. When using a proxy, enter the network proxy information in the format http://my.proxy.server:3128 or http://user:password@my.proxy.server:3128. |
| Host Name Database | Specifies additional hosts to append to /etc/hosts. Separate entries by pressing. Separate entries by pressing Enter. Use the format IP_address space hostname where multiple hostnames can be used if separated by a space. Hosts defined here are still accessible by name even when DNS is not available. See hosts for additional information. |