General Settings Screen

The TrueNAS SCALE System Settings > General screen includes widgets for Support, GUI, Localization, NTP, and system Email functions. Each widget displays information about current settings and includes one or more buttons for related actions and configuration options.

The Manage Configuration dropdown provides three options to backup, restore, or reset system configuration settings.

TrueNAS SCALE allows users to manage the system configuration via uploading/downloading configurations, or resetting the system to the default configuration.

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

The Export Password Secret Seed option includes encrypted passwords in the downloaded configuration file. This option allows you to restore the configuration file to a different operating system device where the decryption seed is not already present. Users must physically secure configuration backups containing the seed to prevent unauthorized access or password decryption.

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

Choose File opens a file browser window where you can locate the downloaded and saved configuration. After selecting the file, it displays in the Upload Config window. Upload uploads the selected configuration file.

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

The Reset to Defaults option opens the Reset Configuration dialog, which resets the system configuration to factory settings and restarts the system. Users must set a new login password.

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

If you do not save the system configuration before resetting it, you may lose data that you did not back up, and you will not be able to revert to the previous configuration.

The Support widget displays general hardware and software specs and contains links to the Documentation Hub, TrueNAS Forums, and offers TrueNAS Licensing information.

Add License opens the License screen.

File Ticket opens the File Ticket screen.

The License screen allows you to copy your license into the box and save it.

Click Here for More Information expand

When prompted to reload the page, click Reload Now.

When the End User License Agreement (EULA) opens, read it thoroughly and completely, then click I AGREE. The Support widget updates to display license and hardware information.

Select This is a production system and click Proceed to send iXsystems email notification that the system is in production.

The File Ticket screen allows you to log into Jira where you can submit a bug report or suggestion ticket. The screen provides the required ticket information fields to complete when submitting an issue report.

Click Here for More Information expand

Setting	Description
Login To Jira	Click to log in to a Jira account.
Category	Select the appropriate category.
Type	Select Bug when reporting an issue or Suggestion when requesting new functionality.
Attach Debug	Set to generate and attach to the new issue a report containing an overview of the system hardware, build string, and configuration. Attaching a debug can take several minutes.
Subject	Enter a descriptive title for the new issue.
Body	Enter a one to three paragraph summary of the issue. Describe the problem and provide any steps to replicate the issue.
Choose File	Select one or more screenshots that illustrate the problem.

Click Save to submit the ticket and open a window with a link to it.

Click User Guide to open a new tab to the Docs Hub.

Click EULA to display the end user license agreement.

Silver/Gold Coverage Customers can enable iXsystems Proactive Support. This feature automatically emails iXsystems when certain conditions occur in a TrueNAS system.

Click Here for More Information expand

To configure Proactive Support, click Proactive Support in the Support widget.

Complete all available fields, and check the Enable iXsystems Proactive Support box, then click Save.

Click Settings on the GUI widget to open the GUI Settings screen that allows users to configure the TrueNAS SCALE web interface address.

Click Here for More Information expand

Click Settings to open the GUI Settings screen.

Setting	Description
Theme	Select a preferred color theme from the dropdown list of eight options.
GUI SSL Certificate	Select a self-signed certificate from the dropdown list. The system uses a self-signed certificate to enable encrypted web interface connections. Manage Certificates opens the Certificates screen.
Web Interface IPv4 Address	Select a recent IP address from the dropdown list to limit 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 Address	Select a recent IPv6 address from the dropdown list 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 HTTP Port	Enter a port number for an HTTP connection to the web interface. Allow configuring a non-standard port to access the GUI over HTTP. Changing this setting might require changing a Firefox configuration setting.
Web Interface HTTPS Port	Enter a port number for an HTTPS connection to the web interface. This field allows configuring a non-standard port to access the GUI over HTTPS.
HTTPS Protocols	Select the Transport Layer Security (TLS) versions TrueNAS SCALE can use for connection security from the dropdown list. Cryptographic protocol for securing client/server connections.
Web Interface HTTP -> HTTPS Redirect	Select to redirect HTTP connections to HTTPS. A GUI SSL Certificate is required for HTTPS. Activating this also 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.
Usage Collection	Select to enable sending anonymous usage statistics to iXsystems.
Show Console Messages	Select to display console messages in real-time at the bottom of the browser.

Click Settings on the Localization widget to open the Localization Settings screen that lets users localize their system to a specific region.

Click Here for More Information expand

Click Settings to open the Localization Settings screen.

Setting	Description
Language	Select a language from the dropdown list.
Console Keyboard Map	Select a language keyboard layout from the dropdown list.
Timezone	Select a time zone from the dropdown list.
Date Format	Select a date format from the dropdown list.
Time Format	Select a time format from the dropdown list.

Click Add on the NTP Servers widget to open the Add NTP Server screen that allows users to configure Network Time Protocol (NTP) servers, which sync the local system time with an accurate external reference.

Click Here for More Information expand

By default, new installations use several existing NTP servers. TrueNAS SCALE supports adding custom NTP servers. Click Add to open the Add NTP Server screen.

Setting	Description
Address	Enter the hostname or IP address of the NTP server.
Burst	Select to use 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.
IBurst	Select to speed up the initial synchronization (seconds instead of minutes).
Prefer	Select when using highly accurate NTP servers such as those with time monitoring hardware. Only use for these highly accurate NTP servers.
Min Poll	Enter the minimum polling interval, 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 Poll	Enter the maximum polling interval, 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.
Force	Select to force the addition of the NTP server, even if it is currently unreachable.

Click Settings on the Email widget to open the Email Options screen that allows users to configure the system email send method.

Click Here for More Information expand

An automatic script sends a nightly email to the administrator account containing important information such as the health of the disks. Users must first configure an email address for the admin account or another administrative user in Credentials > Local Users.

The Email Options screen offers two options to set up email. Select either SMTP or GMail OAuth. The configuration settings change based on the selected radio button.

SMTP

If SMTP is selected, the screen displays the SMTP configuration fields.

Setting	Description
From Email	The email address to use for sending emails. You must first configure the user account email in Credentials > Local Users.
From Name	The name to show in front of the sending email address, for example: TrueNAS.
Outgoing Mail Server	Host name or IP address of SMTP server to use for sending emails.
Mail Server Port	SMTP port number. Typically 25, 465 (secure SMTP), or 587 (submission).
Security	Select the security option from the dropdown list. Options are Plain (No Encryption), SSL (Implicit TLS), or TLS (STARTTLS). See email encryption for more information on types.
SMTP Authentication	Select to enable SMTP AUTH using PLAIN SASL. Requires a valid user name and password.
Username	Displays when SMTP Authentication is selected. The user name for the sending email account, typically the full email address.
Password	Displays when SMTP Authentication is selected. The password for the sending email account.

Send Test Mail generates a test email to confirm the system email works correctly.

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

Gmail OAuth

If GMail OAuth is selected, the screen displays Log in to Gmail to set up Oauth Credentials and the Log In To Gmail button.

After setting up Gmail OAuth authentication, the screen displays Gmail credentials have been applied and the button changes to Log In To Gmail Again.

Send Test Mail generates a test email to confirm the system email works correctly.

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

Related Content

• Settings Options
• Advanced
• Managing Cron Jobs
• Managing the Console Setup Menu
• Managing the System Configuration
• Managing General Settings
• Managing System Logging
• Advanced Settings
• Advanced Settings Screen

Related Console Articles

• Managing the Console Setup Menu
• Using the Console Setup Menu
• Advanced Settings Screen