First Time Login
7 minute read.Last Modified 2021-10-12 15:35 EDT
Now that you have installed and configured TrueNAS SCALE, you can log in to the web interface and begin managing data!
After installing TrueNAS, you can configure and use the system through the web interface.
Important: Use only the web interface to make configuration changes to the system.
By default, using the command-line interface (CLI) to modify the system does not modify the settings database. The system reverts to the original database settings when it restarts and wipes any user-made command line changes. TrueNAS automatically creates several ways to access the web interface, but you might need to adjust the default settings for your network environment.
By default, fresh installs of TrueNAS SCALE provide a default address for logging in to the web interface. To view the web interface IP address or reconfigure web interface access, connect a monitor and keyboard to your TrueNAS system or connect with IPMI for out-of-band system management.
When powering on a TrueNAS system, the system attempts to connect to a DHCP server from all live interfaces to access the web UI. On networks that support Multicast Domain Name Services (mDNS), the system can use a hostname and domain to access the TrueNAS web interface. By default, TrueNAS uses the hostname and domain truenas.local. To change the hostname and domain in the web interface, go to Network and click Settings in the Global Configuration window.
To access the web interface using an IP address, use the one that the Console Setup Menu generated after installing SCALE, or use the one you configured in the Post-install Configuration article if you upgraded from CORE.
We recommend a strong login password!
You can reset the root password in the TrueNAS console setup menu or web interface by going to Credentials > Local Users and editing the
On a computer with access to the same network as the TrueNAS system, enter the hostname and domain or IP address in a web browser to connect to the web interface.
root username and account password that you created during installation.
If the user interface is not accessible by IP address from a browser, check these things:
- If the browser configuration has proxy settings enabled, disable them and try connecting again.
- If the page does not load, ensure a
pingreaches the TrueNAS system IP address. If the IP address is in a private range, you must access it from within that private network.
If the web interface displays but seems unresponsive or incomplete:
- Try a different browser. We recommend Firefox.
If the UI becomes unresponsive after an upgrade or other system operation, clear the site data and refresh the browser (Shift+F5).
After logging in, you will see the system Dashboard. The dashboard displays basic information about the installed version, systems component usage, and network traffic. For users with compatible TrueNAS Hardware, clicking the system image will take you to the System Settings > Enclosure page.
The Dashboard provides access to all TrueNAS management options. The top row has links to outside resources and buttons to control the system. The left-hand column lets users navigate to the various TrueNAS Configuration screens.
Users can select which widgets appear on the dashboard by clicking Configure.
Buttons in the top bar menu link to the iXsystems site, display the status of TrueCommand, and show system processes and configuration menus.
The iXsystems button opens the iXsystems home page where users can find information about storage and server systems.
Users can also use the iXsystems home page to access their customer portal and community section for support.
The Status of TrueCommand button lets users sign up with and connect to TrueCommand Cloud.
Clicking SIGNUP will open the TrueCommand signup page in a new tab.
Once users have signed up, they can click the CONNECT button and enter their API key to connect SCALE to TrueCommand Cloud.
The Task Manager displays all running and failed jobs/processes.
Users can click the History button to open the Jobs screen. Jobs lists all Successful, Active, and Failed jobs. Users can also click View Logs next to a failed process to view its log information and error message.
The Alerts button displays the Alerts menu, which shows all current alerts. Users may dismiss alerts individually, or all at once.
The Alerts menu also lets users configure Alert Settings, Alert Services, and Email.
The Alert Settings screen has options for setting the warning level and frequency for alerts specific to application actions.
The Set Warning Level drop-downs customize alert importance. Each warning level has an icon and color to express its urgency.
The Set Frequency drop-downs adjust how often the system sends alert notifications. Setting the Frequency to NEVER prevents that alert from being in the Alerts menu, but it will still pop up in the UI if triggered.
The Alert Services screen has options to create and edit alert services. The Alert Services screen displays existing alert services in a list that users can filter by Type, Level, and Enabled.
To create a new alert service, click Add and fill out the form, then click Save.
Name and Type
|Name||Name of the new alert service.|
|Enabled||Unset to disable this service without deleting it.|
|Type||Choose an alert service to display options for that service.|
|Level||Select the level of severity.|
|AWS Region||Enter the AWS account region.|
|ARN||Topic Amazon Resource Name (ARN) for publishing. Example: arn:aws:sns:us-west-2:111122223333:MyTopic.|
|Key ID||Access Key ID for the linked AWS account.|
|Secret Key||Secret Access Key for the linked AWS account.|
The SEND TEST ALERT button generates a test alert to confirm the alert service will work correctly.
The Email screen has options for users to set up a system email address.
|From Email||The user account Email address to use for the envelope From email address. The user account Email in Accounts > Users > Edit must be configured first.|
|From Name||The friendly name to show in front of the sending email address. Example: Storage System firstname.lastname@example.org|
|SMTP||Enable SMTP configuration.|
|GMail OAuth||Enable GMail OAuth authentication.|
|Outgoing Mail Server||Hostname or IP address of SMTP server to use for sending this email.|
|Mail Server Port||MTP port number. Typically 25,465 (secure SMTP), or 587 (submission).|
|Security||Email encryption type. Choices are Plain (No Encryption), SSL (Implicit TLS), or TLS (STARTTLS).|
|SMTP Authentication||Enable SMTP AUTH using PLAIN SASL. Requires a valid Username and Password.|
The Send Test Mail button generates a test email to confirm the system email works correctly.
The Settings button has options for passwords, web interface preferences, API Keys, and TrueNAS information.
Clicking Change Password allows users to change the currently logged-in administrator password.
Clicking Preferences lets users select general preferences for the system.
|Choose Theme||Choose a preferred theme.|
|Prefer buttons with icons only||Preserve screen space with icons and tooltips instead of text labels.|
|Enable Password Toggle||When set, an eye icon appears next to password fields. Clicking the icon reveals the password.|
|Reset Table Columns to Default||Reset all tables to display default columns.|
|Retro Logo||Revert branding back to FreeNAS.|
|Reset All Preferences to Default||Reset all user preferences to their default values (custom themes are preserved).|
The API Keys section lets users add API Keys that identify outside resources and applications without a principal.
Users may also click DOCS to access their system’s API documentation.
Clicking the Guide button opens the TrueNAS Documentation Hub in a new tab.
Clicking the About button brings up links to the TrueNAS Documentation Hub, the TrueNAS Community Forums, the FreeNAS Open Source Storage Appliance GitHub repository, and the iXsystems homepage.
Now that you can access the TrueNAS web interface and see all the management options, it’s time to begin storing data!