TrueNAS Early Release Documentation
This content follows TrueNAS 25.10 (Goldeye) early release versions. Pre-release software is intended for testing purposes only.
Use the Product and Version selectors above to view content specific to a different software release.

General Settings Screen

9 minute read.

Last Modified 2025-09-18 10:51 EDT

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

Support
GUI
Localization
Email

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

Community systems show the same widgets, but are not eligible for Enterprise support options or licenses.

The This is a production system toggle, which shows only on TrueNAS Enterprise systems, opens the Update Production Status dialog.

Add License opens the License screen. After adding a license, Update License replaces the Add License button.

Get Support dropdown shows two options: File Ticket and Proactive Support when the system is an Enterprise-licensed system. Non-Enterprise licensed systems only show the File Ticket option.

Save Debug starts downloading a system debug file to the local machine.

Update Production Status Dialog

The Update Production Status dialog can set a TrueNAS Enterprise system to production status and can send an initial system debug to TrueNAS.

Send initial debug starts the debug download and file transfer to TrueNAS.

Proceed starts the process and sets the system to a production system.

Send Feedback Window

The Send Feedback window shows two options: Rate this page and Report a Bug, which is the default selection after clicking File Ticket. The Rate this page is the default selection after clicking the option to rate a new screen shown in early release with new functional screens or redesigned screens.

Report a Bug

Subject is a text entry field for a brief description of an issue experienced. For example, Traceback received when pressing Save.

Message is a text entry field for a longer description of what steps were taken and the result. The field provides examples of what to enter. This content populates the Jira ticket description field after clicking Login To Jira To Submit.

Attach debug, which is selected by default, downloads and attaches a system debug to the Private Attachment Area TrueNaS provides to secure user confidential data that is part of the debug file.

Take screenshot of the current page, selected by default, takes a screenshot of the current screen.

Attach additional images opens a file browser where you can locate and attach saved logs, screenshots, or video files that help explain the issue reported in the ticket.

Login To Jira To Submit opens a Jira login screen where you enter your Jira credentials so TrueNAS can create the ticket for you using your credentials.

Rate this page

Select the Rate this page to show options to submit review feedback on a UI screen.

Stars set a rating using one (lowest) to five (best) stars.

Message is a text entry field for comments about the screen you are rating. Include what you like, don’t like, works well, or does not work well, and your exerience with the screen.

Take screenshot of the current page, selected by default, takes a screenshot of the current screen.

Attach additional images opens a file browser where you can locate and attach saved screenshots or video files that help explain what you report in the ticket.

The on our forum link opens the TrueNAS Community forum.

Submit sends the report to TrueNAS.

License Screen

The License screen opens after clicking either Add License or Update License on the Support widget on the General Settings screen. It allows pasting a copy of your license into the form and saving it.

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.

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.

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

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

GUI Settings Screen

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

GUI Settings

Setting	Description
Theme	Sets a color theme to the option selected from the dropdown list. 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 Certificate	Sets the selected certificate as the SSH certificate. truenas_default is the default certificate. The system uses a self-signed certificate to enable encrypted web interface connections. Manage Certificates opens the Certificates screen. Certificates added or imported into TrueNAS show on this list.
Web Interface IPv4 Address	Sets 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 Address	Sets 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 Port	Sets 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 Port	Sets a non-standard port to access the GUI over HTTPS. The default is 443.
HTTPS Protocols	Sets 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 Redirect	Redirects 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 Collection & UI Error Reporting	When enabled, anonymous usage statistics and WebUI errors are reported to the TrueNAS engineering team. No personally identifiable information is collected. When disabled, anonymous usage statistics consisting only of the software version and total system capacity (e.g. TrueNAS 24.04.0, 55 TB) are still collected. Information about system configuration and usage is not collected. For more information about what usage data is collected, see the TrueNAS Data Collection Statement.
Show Console Messages	Shows console messages in real-time at the bottom of the browser screen.

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.

Settings opens the Localization Settings configuration screen.

Localization Settings

Setting	Description
Language	Sets 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. Allows filtering the list by typing in the field after clearing the default value. Or scroll down to locate and select a language from the dropdown list.
Console Keyboard Map	Sets a language for the keyboard layout, for example, English (US) for American English. Select an option on the dropdown list, or type in the field to filter the list to show matching languages.
Timezone	Set the geographical time zone for the system. Allows filtering the list by typing in the field after clearing the default value. Or scroll down to locate and select a timezone from the dropdown list.
Date Format	Sets the date format to the option selected on the dropdown list.
Time Format	Sets the time format to the option selected on the dropdown list.

Email Options Screen

The Email widget shows the email configured on the system. Settings opens the Email Options configuration screen. Setting options 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 for the SMTP option shows standard email configuration settings.

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

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

SMTP Settings

Setting	Description
From Email	Sets the user account email address used for the envelope From email address, the address sending emails.
From Name	Sets the name shown in front of the sending email address, for example, truenas system 1 in truenas system 1@example.com.
Outgoing Mail Server	Sets the host name or IP address of the SMTP server used to send emails.
Mail Server Port	Sets the SMTP port number. Typically 25, 465 (secure SMTP), or 587 (submission).
Security	Sets 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 Authentication	Select 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.
Username	Shows 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.
Password	Shows 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

Use Cases

Industry

Support

Resources