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.
Top Toolbar
10 minute read.
The top toolbar buttons allows for quick software feedback, displays the status of TrueCommand and directory services configured on your system, active alerts, and shows other system management options.
| Icon | Name | Description |
|---|---|---|
| Toggle collapse | Click to expand or collapse the main menu panel on the left side of the screen. | |
 | Search UI | Searches UI screens and elements or redirects queries to the TrueNAS Documentation Hub. |
| Send Feedback | Opens the Send Feedback feedback window for sending UI ratings and bug reports to the TrueNAS developers. | |
| Status of TrueCommand | Displays either the status of a TrueCommand cloud connection or a dialog that allows users to sign up for a new TrueCommand cloud connection. | |
| Status of TrueNAS Connect | Opens the TrueNAS Connect dialog that shows the current status of the service and allows you to connect to and open the login screen for TrueNAS Connect. | |
| Update Status | Shows the system update progress and which user account started the update. Only appears in the top bar when a TrueNAS system update starts. | |
| Directory Services status | Displays a dialog with the status of Active Directory and LDAP directory servers configured on the system. | |
| Running Jobs | Displays the Running Jobs dialog. Click the History button to display the Tasks screen with a list of All, Active or Failed tasks or processes. | |
| Alerts | Displays a list of system alerts and a dropdown list with the alert options Alert Settings and Email. | |
| Settings | Displays a dropdown list of setting options Change Password, Two-Factor Authentication (when enabled), My API Keys, Guide, and Log Out. | |
| Power options | Displays the power related options Restart or Shut Down. |
The Search UI global search bar allows users to search for screens and elements within the TrueNAS UI or to redirect search terms to the TrueNAS Documentation Hub.
Using Global Search
Click the Search UI bar or type Ctrl + / to select the UI global search.
Enter a keyword to search for elements within the TrueNAS UI. For example, enter SMB to search for results relating to SMB shares and the SMB service.
Global search returns UI screens, widgets, and button names matching the entered query. Click View More to view additional results, if needed.
Select a screen result under UI to go to the matching screen within the TrueNAS UI. For example, select Shares arrow_right_alt SMB to go to the SMB screen.
Select a widget or button result to go to the screen containing the element. For example, select Shares arrow_right_alt SMB arrow_right_alt Add SMB Share to locate to the Add button on the SMB screen.
TrueNAS indicates the selected element with a glow effect.
Click Search Documentation for «query» to redirect the search to the TrueNAS Documentation Hub. TrueNAS opens a new browser tab to display documentation search results for the query.
Use this option to search for tutorials and UI reference documentation for the feature, or to look for further information when the entered search term does not find any matching UI elements.
TrueNAS provides two feedback options, one to rate a UI screen and the other to report a problem encountered with the system.
To send feedback, click the Send Feedback icon on the top toolbar to open the Send Feedback window. Alternatively, go to System > General Settings and click File Ticket on the Support widget.
Click Rate this page to send feedback on a UI page. You can include a screenshot of the current page and/or upload additional images with your comments. You can also click the link to visit the TrueNAS forum, where you can vote for new features, report problems, or suggest improvements directly to the development team.
Click Report a bug to create an engineering ticket when a TrueNAS screen or feature is not working as intended. This submits the ticket directly to the TrueNAS development team. Submitting a bug report requires a free Atlassian account.
Issue Reporting Example
Click Report a bug to see the fields to create an engineering ticket for system errors, bugs, or unexpected behavior. For example, report a bug where a middleware error and traceback occurred while saving a configuration change.
Bug reports are created in the publicly visible TrueNAS Jira project.
Enter a descriptive summary in the Subject. For example, if a configuration change does not update after clicking Save and you get an error message or traceback after attempting the change, enter XYZ setting fails to save with a traceback in Subject. Enter the details of actions taken that resulted in the error or failed action in Message. With the same example, enter more details on the issue: I clicked the edit XYZ settings option, modified the XYZ setting, and clicked Save. The operation failed and showed the following traceback message: [include the traceback text]. My system is running TrueNAS 25.10.0. Keep the details concise and focused on how to reproduce the issue, what you expected from the actions taken, and the actual result. This helps ensure a speedy ticket resolution.
Include system debug and screenshot files to speed up the issue resolution. Select Attach debug. To attach a screenshot of the current page, select Take screenshot of the current page. Or, before using this form, take screenshots of the screen, traceback or other error message, copy a log into a text file, or create any other file to attach. Open this form and attach those files by selecting Attach additional images and clicking Choose File to open a File Explorer window where you can browse to select the files you want to attach to the report.
TrueNAS can show a list of existing Jira tickets with similar summaries.
When there is an existing ticket about the issue, consider clicking on that ticket and leaving a comment instead of creating a new one. Duplicate tickets are closed in favor of consolidating feedback into one report.
Click Login To Jira To Submit to finish and submit the report.
TrueNAS Enterprise
When an Enterprise license is applied to the system, the Report a bug screen includes additional environment and contact information fields for sending bug reports directly to the TrueNAS team.
Filling out the entire form with precise details and accurate contact information ensures a prompt response from the TrueNAS Customer Support team.
The Status of TrueCommand icon lets users sign up with and connect to TrueCommand Cloud.
Clicking Signup opens the TrueCommand sign-up page in a new tab.
After users sign up, they can click the Connect button and enter their API key to connect TrueNAS to TrueCommand Cloud.
TrueNAS displays a message telling users to check their email for verification instructions.
TrueNAS provides quick access to TrueNAS Connect from the top toolbar in your TrueNAS system. The Status of TrueNAS Connect icon opens the TrueNAS Connect dialog. Before you sign up for TrueNAS Connect, the dialog shows it is waiting to connect.
Click Get Connected to open the TrueNAS Connect sign-in screen.
After connecting to TrueNAS Connect and registering the system, the Status of TrueNAS Connect icon shows an active status indicator. The TrueNAS Connect dialog shows the status of the active connection.
Click Open TrueNAS Connect to open the TrueNAS Connect management interface. Click cloud_off Disable Service to disconnect the system from TrueNAS Connect.
See connect.truenas.com for more information.
When configured, the Directory Services Monitor icon button displays the status of Active Directory and LDAP services.
Click on either service to go to its configuration screen.
The Running Jobs icon button opens the Running Jobs window showing a minimized view of all running, waiting, and failed jobs/processes. Hover the mouse over an error job to view a pop-up window with the error message for that failed job.
Click the minus (-) at the top right corner of any dialog or pop-up window to minimize a job/process.
Click on a running job to open a dialog for that job.
A running job shows a progress bar and a stop_circle button to the right of the job. Click on this to show the Abort dialog. Click Abort to stop the job and abort the process.
Beginning in 25.04, the Abort option is only available for select jobs. Jobs that are unable to be aborted are listed without the stop_circle button as an option.
Click on Go to Jobs to open the Jobs screen with tabs to screens listing all successful, active, or failed and aborted jobs. Click on the All, Active, or Failed button at the top of the screen to show the log of jobs that fit that classification.
Click View next to a task to see the log information and error message for that task.
For more information, see Jobs Screens.
The Alerts icon displays a list of current alert notifications. To remove an alert notification click Dismiss below it or use Dismiss All Alerts to remove all notifications from the list.
Use the icon to display the Alerts dropdown list with two options: Alert Settings and Email.
Select Alert Settings to add or edit existing system alert services and configure alert options such as the warning level and frequency and how the system notifies you. See Alerts Settings Screens for more information.
The Alert Settings Screens article includes information about the TrueNAS Enterprise high availability (HA) alert settings.
Select Email to configure the method for the system to send email reports and alerts. See Setting Up System Email for information about configuring the system email service and alert emails.
The Settings button displays a menu of general system settings options. The options are Change Password, Two-Factor Authentication (when enabled), MY API Keys, Guide and Log Out.
The Change Password button displays a dialog where you can change the login password for the currently logged-in administrator password.
The Two-Factor Authentication button displays only when global 2FA is configured and opens the Two-Factor Authentication Screen.
The My API Keys button displays the API Keys screen that lists current API keys and where you can add or manage API keys that identify outside resources and applications without a principal.
The Guide button opens the TrueNAS Documentation Hub website in a new browser tab.
The Log Out button logs the current user out of the TrueNAS UI.
The Power button provides two options that let the user restart or shut down their TrueNAS system.