TrueNASTrueNAS Nightly Development Documentation
This content follows experimental nightly development software. Pre-release software is intended for testing purposes only.
Use the Product and Version selectors above to view content specific to a stable software release.

Managing Network Global Configurations

Use the Global Configuration Settings screen to manage existing general network settings like the default gateway and DNS servers. Set DHCP to assign the IPv4 address, or manually set a static IP address, add IP address aliases, and set up services to allow external communication.

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.

Tutorial Video

(Video URL: https://www.truenas.com/docs/files/scaleangelfishstaticipglobalnetworking.mp4)

Can I configure these options elsewhere? Users can configure many of the interface, DNS, and gateway options using the Console Setup menu. Be sure to check both locations when troubleshooting network connectivity issues.

Adding Network Settings

Use the Global Configuration Settings screen to add general network settings like the default gateway and DNS name servers to allow external communication.

To add new or change existing network interfaces see Interface Configurations.

Go to Network, and click Settings on the Global Configuration widget to open the Edit Global Configuration screen.

  1. Enter the host name for your TrueNAS in Hostname. For example, replace the default value truenas with something like localnas.

  2. Enter the system domain name in Domain. For example, example.com.

  3. Enter the IP addresses for your DNS name servers in Nameserver 1, Nameserver 2, and/or Nameserver 3. For home users, enter 8.8.8.8 in the Nameserver 1 field so your TrueNAS can communicate externally with the Internet.

  4. Enter the IP address for your default gateway into the IPv4 Default Gateway if you are using IPv4 IP addresses. Enter the IPv6 address in the IPv6 Default Gateway if you are using IPv6 addresses.

  5. Select Allow All for Outbound Network to permit external communication for all TrueNAS services or select Deny All to prevent external communication. Select Allow Specific and then use the dropdown list to pick a limited set of services to allow external communication.

    Click as many services as desired to permit external communications. Unchecked services cannot communicate externally.

See below for more information.

  1. Click Save. The Global Configuration widget on the Network screen updates to show the new settings.

Setting Up External Communication for Services

Use the Global Configuration Outbound Network settings to add services for external communication capability.

These services use external communication:

  • ACME DNS-Authenticators
  • Anonymous usage statistics
  • Catalog(s) information exchanges
  • Cloud sync
  • KMIP
  • Mail (email service)
  • Replication
  • Rsync
  • Support
  • TrueCommand iX portal
  • Updates
  • VMWare snapshots

Select Allow All to permit all of the above services to communicate externally. This is the default setting.

Select Deny All to prevent all of the above services from communicating externally.

Select Allow Specific to permit external communication for the services you select. Allow Specific displays a dropdown list of selectable services. Click on all that apply. A checkmark displays next to a selected service, and these services display in the field separated by a comma (,).

Click Save when finished.