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.

Preparing for TrueNAS UI Configuration (Enterprise)

TrueNAS Enterprise

TrueNAS Enterprise customers, or those that purchased systems and service contracts from iXsystems, should use the information in this article to prepare for their TrueNAS system deployments.

The iXsystems Support department provides assistance with the configuration areas documented in this section.

Contacting Support

Customers who purchase iXsystems hardware or that want additional support must have a support contract to use iXsystems Support Services. The TrueNAS Community forums provides free support for users without an iXsystems Support contract.

iXsystems Customer Support
Support Portalhttps://support.ixsystems.com
Emailsupport@ixsystems.com
Telephone and Other Resourceshttps://www.ixsystems.com/support/

Required Access and Information

Because there are many possible scenarios for network configurations, this section covers the basics of the access and information required to configure TrueNAS to work in your network environment. If you are the individual tasked with installing and configuring the TrueNAS server but are not responsible for network services in your company, contact your network administrator to request they provision and verify new IP address assignments and provide the other information for access.

Physical Access

When in the same location as the hardware designated for the TrueNAS installation, you can connect a monitor and keyboard to the system to do the initial installation and configuration. An additional USB port is required when using a USB storage device to install TrueNAS from an .iso file.

IPMI Access

The Intelligent Platform Management Interface (IPMI) provides a way for system administrators to remotely access their TrueNAS system. Through this remote access, administrators can install software, and configure or administer systems at the console level as though they are in the room with the server. TrueNAS Enterprise systems sold by iXsystems provide IPMI network ports, but other hardware might not have IPMI ports.

iXsystems requires access through your IPMI server to access the TrueNAS server to provide remote administration support. To make this possible:

  • Assign an IP address to the IPMI port of each controller in the TrueNAS array. If you have a High Availability (HA) system, the server is equipped with two controllers so assign two IP addresses, one for each controller.
  • Create and provide administrator credentials (user name and password) for access to the TrueNAS IPMI connections. Configure the administrator credentials to access both IP addresses assigned to the HA system controllers.

Network Access

TrueNAS uses DHCP to assign the IP address to the primary system network interface. DHCP only provisions one IP address. You can use this DHCP-provided address, or you can assign a static IP address. You must assign an IP address to each network interface card (NIC) installed in your system if you want to communicate over your network using the interfaces.

To configure your TrueNAS server to work with your network, you need:

  • DHCP broadcast messages enabled on the network or the subnet(s) in your network where TrueNAS is installed.
  • DNS name sever IP addresses in your network (TrueNAS can accommodate up to three name server IP addresses).
  • IP address for the Network Time Protocol (NTP) server you use to synchronize time across your servers and network.
  • Main domain name or the domain name for the portion of your network where the TrueNAS server is deployed.
  • Host name you want to use if not using the default-assigned host name in TrueNAS (truenas).
  • IP address for each additional network interface added in your system and connected to your network (static IP not provided by DHCP).
  • IP address assigned to the controller. Either allow DHCP to assign the IP address or assign a static IP.

If you have an HA system with two controllers, you must assign a total of three IP addresses:

  • A virtual IP for access to the UI when either controller is active
  • An IP address for the primary network port on controller A
  • An IP address for the primary network port on controller B

iXsystems Support can assist you with any questions you have with these network requirements. Provide the information listed to iXsystems when requested to expedite configuring your system network settings.

SMTP Access

Simple Mail Transfer Protocol (SMTP) service or servers allow for the transfer of electronic mail across an Internet connection. TrueNAS uses either SMTP to send mail from TrueNAS to administrator or designated individual email addresses for system alert notifications.

Have your network administrators provide the SMTP addresses to allow TrueNAS to send emails from your network.

Directory Service Access

TrueNAS works with either Active Directory or LDAP directory servers, and it can also work with Kerberos and IDmap. Active Directory and LDAP configuration settings have similar requirements. Additionally, consider implementing two-factor authentication (2FA) for enhanced security when authenticating users against Active Directory or LDAP directory servers.

Active Directory

Provide the following information to configure TrueNAS Active Directory access:

  • Domain name for where the Active Directory server is located
  • Authentication credentials for access to the Active Directory server (admin user name and password to allow TrueNAS to communicate with the server)
  • List of trusted domains TrueNAS should allow
LDAP

Provide the following information to configure TrueNAS LDAP access:

  • Host name where the LDAP sever is located and where TrueNAS accesses it
  • Base and bind distinguished names (DN) and the bind password which are the authentication credentials
  • Kerberos realm and keytab information if used in your directory server deployment for TrueNAS to use for authentication
Advanced Directory Services

When configuring Kerberos and/or IDmap, you might need to provide:

  • Kerberos realm and keytab information
  • IDmap schema information