General Settings Screen

The General Settings screen has five widgets that show current general system settings and include buttons for related actions and configuration options. The widgets are:

General Settings Screen
Figure 1: General Settings Screen

Manage Configuration

The Manage Configuration dropdown shows two options, one to download the system config file and the other to upload a system config file. The option to reset system settings to the default configuration shows after uploading a configuration file.

Download File

The Download File option opens the Save Configuration dialog, where users can download the current system configuration to the local machine.

Save Configuration
Figure 2: Save Configuration

The Export Password Secret Seed option stores hashes of the passwords sufficient for authentication in the system. It does not store user passwords. The secret seed is used to decrypt encrypted fields in the TrueNAS configuration database. Various fields are encrypted because they might contain sensitive information such as cryptographic certificates, passwords (not user login passwords), or weak hashing algorithms (for example, NT hashes of SMB users). When a config file is restored without the secret seed, encrypted fields are set to empty values. This means various services can be broken due to the missing information. Examples are SMB via local accounts and apps.

Upload File

The Upload File option opens the Upload Config dialog, which allows users to choose a previously saved TrueNAS configuration to replace the current system configuration.

Upload Config
Figure 3: Upload Config

Choose File opens a file browser window to locate the downloaded and saved configuration file. After selecting the file, the Upload Config window opens. Upload uploads the selected configuration file.

All passwords reset if the uploaded configuration file was saved without Export Password Secret Seed enabled.

Reset to Defaults

The Reset to Defaults option opens the Reset Configuration dialog. Using Resetting to Defaults returns the system configuration to factory settings and restarts the system. Users must set a new login password.

Reset Configuration
Figure 4: Reset Configuration

Save the current system configuration with the Download File option before resetting the configuration to default settings.

Not saving the system configuration before resetting it, can result in losing data that is not backed up, and losing the ability to revert to the previous configuration.

Support Widget

The Support widget shows general hardware and software specifications and links to the Documentation Hub, TrueNAS Forums, and offers TrueNAS Licensing information.

Support Widget
Figure 5: Support Widget

Add License opens the License screen.

File Ticket opens the Send Feedback window.

License Screen

The License screen allows copying your license pasting it in the form and saving it.

License Entry
Figure 6: License Entry

Reload Now reloads the page.

End User License Agreement (EULA) opens a copy of the TrueNAS end user license agreement. I AGREE digitally marks it signed, then closes the screen and updates the Support widget with the license and hardware information.

Support Widget with License
Figure 7: Support Widget with License

This is a production system indicates the system is used in a production, non-test environment. Proceed sends TrueNAS an email notification that the system is in production.

Proactive Support Screen

Silver/Gold coverage customers can enable proactive support. This feature automatically emails TrueNAS when certain conditions occur in a TrueNAS system.

Proactive Support opens a window where you configure proactive support.

Proactive Support Form
Figure 8: Proactive Support Form

Primary Contact and Secondary Contact fields specify customer name, title, and contact information.

Enable iXsystems Proactive Support and Save notifies the TrueNAS team the system is configured for proactive support.

GUI Settings Screen

The GUI Settings screen shows configuration settings for the TrueNAS web interface.

GUI Settings Screen
Figure 9: GUI Settings Screen
GUI Settings
SettingDescription
ThemeSets a color theme selected from the dropdown list of options. Options are: ixDark (default option), ixBlue, Dracula, Nord, Paper, Soloarized Dark, Midnight, and High Contrast. Selecting an option immediately changes the UI to the selected color theme.
GUI SSL CertificateSets the selected certificate as the SSH certificate. truenas_default is the default self-signed certificate. The system uses a self-signed certificate to enable encrypted web interface connections. Manage Certificates opens the Certificates screen. Certificates added to TrueNAS show on this list.
Web Interface IPv4 AddressSets an IP address to limit the usage when accessing the administrative GUI. The built-in HTTP server binds to the wildcard address of 0.0.0.0 (any address) and issues an alert if the specified address becomes unavailable.
Web Interface IPv6 AddressSets an IPv6 address from the dropdown list to limit usage when accessing the administrative GUI. The default is ::. The built-in HTTP server binds to the wildcard address of 0.0.0.0 (any address) and issues an alert if the specified address becomes unavailable.
Web Interface HTTP PortSets a non-standard port to access the GUI over HTTP. The default is 80. Changing this setting might require changing a Firefox configuration setting.
Web Interface HTTPS PortSets a non-standard port to access the GUI over HTTPS. The default is 443.
HTTPS ProtocolsSets a cryptographic protocol(s) for securing client/server connections. Select the Transport Layer Security (TLS) versions TrueNAS can use for connection security from the dropdown list of options:
  • TLSv1
  • TLSv1.1
  • TLSV1.2 selected by default
  • TLSv1.3 (selected by default)
  • Web Interface HTTP -> HTTPS RedirectRedirects HTTP connections to HTTPS. A GUI SSL certificate is required for HTTPS. Activating this sets the HTTP Strict Transport Security (HSTS) maximum age to 31536000 seconds (one year). This means that after a browser connects to the web interface for the first time, the browser continues to use HTTPS and renews this setting every year. After adding a new certificate select it or use the default TrueNAS certificate in GUI SSL Certificate.
    Usage CollectionEnables sending anonymous usage statistics to iXsystems when selected. For more information about what usage data is collected, see the TrueNAS Data Collection Statement.
    Show Console MessagesShows console messages in real-time at the bottom of the browser when enabled.

    Localization Settings Screen

    The Localization widget shows the current language, date, time format, time zone, and console keyboard map settings for the TrueNAS system. Provides access to a configuration screen to customize settings.

    Localization Settings Screen
    Figure 10: Localization Settings Screen

    Settings opens the Localization Settings configuration screen.

    Localization Settings Screen
    Figure 11: Localization Settings Screen
    Localization Settings
    SettingDescription
    LanguageSets the language for the UI screens. The default setting is English but might be customized to the language based on the country of origin for an Enterprise customer. Clear the field and begin typing to filter the list or scroll down and select a language from the dropdown list.
    Console Keyboard MapSets a language for the keyboard layout, for example, English (US) for American English. Select and option the dropdown list.
    TimezoneSet the geographical time zone for the system. Clear the field and begin typing to filter the list or scroll down to select a time zone from the dropdown list.
    Date FormatSets a date format to what is selected on the dropdown list.
    Time FormatSets a time format to what is selected on the dropdown list.

    Add NTP Server Screen

    The Add NTP Server screen shows Network Time Protocol (NTP) server settings that sync the local TrueNAS system with an accurate external reference. By default, new installations use several existing NTP servers. TrueNAS supports adding custom NTP servers.

    Add on the NTP Servers widget opens the Add NTP Server screen.

    Add NTP Server Screen
    Figure 12: Add NTP Server Screen
    Add NTP Server Settings
    SettingDescription
    AddressSets the host name or IP address of the NTP server.
    BurstEnables using a non-public NTP server. Recommended when Max Poll is greater than 10. Only use on personal NTP servers or those under direct control. Do not enable it when using public NTP servers.
    IBurstEnables and speeds up the initial synchronization (seconds instead of minutes).
    PreferEnable when using highly accurate NTP servers such as those with time monitoring hardware. Only use for these highly accurate NTP servers.
    Min PollSets the minimum polling interval. Enter a numeric value in seconds, as a power of 2. For example, 6 means 2^6, or 64 seconds. The default is 6, and the minimum value is 4.
    Max PollSets the maximum polling interval. Enter a numeric in seconds, as a power of 2. For example, 10 means 2^10, or 1,024 seconds. The default is 10, and the maximum value is 17.
    ForceEnable to force the addition of the NTP server, even if it is currently unreachable.

    Email Options Screen

    The Email widget shows the send-email method configured in TrueNAS, such as SMTP.

    Settings opens the Email Options configuration screen. Settings change based on the selected send-mail method. Options:

    • SMTP shows standard SMTP configuration settings.
    • GMail OAuth shows the Gmail configuration options.
    • Outlook OAuth shows Outlook configuration options.

    SMTP Email Options

    The Email Options screen with SMTP selected shows standard email configuration settings.

    SMTP Email Options
    Figure 13: SMTP Email Options

    Send Test Mail generates a test email to confirm the system email settings entered work correctly.

    Save stores the email configuration and closes the Email Options screen.

    SMTP Settings
    SettingDescription
    From EmailSets the user account email address used for the envelope From email address, the address sending emails, and configured on either the add or edit user screen. For more information, see User Screens.
    From NameSets the name shown in front of the sending email address, for example, truenas system 1 in truenas system 1@example.com.
    Outgoing Mail ServerSets the host name or IP address of the SMTP server used to send emails.
    Mail Server PortSets the SMTP port number. Typically 25, 465 (secure SMTP), or 587 (submission).
    SecuritySets the security option to what is selected on the dropdown list. Options are:
  • Plain (No Encryption)
  • SSL (Implicit TLS)
  • TLS (STARTTLS)
  • For more information on types, see email encryption.
    SMTP AuthenticationSelect to enable SMTP AUTH using plain Simple Authentication and Security Layer (SASL) for authentication and data security. Applies and requires a valid simple username and password authentication method.
    UsernameShows after selecting SMTP Authentication. Sets the username of the sending email account, which is typically the full email address. Enter the username if the SMTP server requires authentication.
    PasswordShows after selecting SMTP Authentication. Sets the password for the sending email account, for the SMTP server. Only plain ASCII characters are accepted.

    OAuth Email Options

    Gmail OAuth and Outlook OAuth options show the From Email and From Name fields and a log-in-to button for the email method selected. GMail OAuth shows Log In To Gmail and Outlook OAuth shows Log In To Outlook. These login methods step through a sequence of login screens for the selected method. For more information, see Setting Up System Email