(408) 943-4100               V   Commercial Support Toggle between Light and Dark mode

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.

Web Interface Access

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 root user.

Logging In

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.

LoginSCALE

Enter the 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 ping reaches 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:

  • Make sure the browser allows cookies, Javascript, and custom fonts from the TrueNAS system.
  • 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).

Dashboard

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.

DashboardSCALE

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.

ConfigureWidgetsSCALE

Top Bar Menu

Buttons in the top bar menu link to the iXsystems site, display the status of TrueCommand, and show system processes and configuration menus.

TopRowSCALE

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.

StatusOfTrueCommandSCALE

Clicking SIGNUP will open the TrueCommand signup page in a new tab.

SignUpTrueCommandSCALE

Once users have signed up, they can click the CONNECT button and enter their API key to connect SCALE to TrueCommand Cloud.

ConnectToTrueCommandSCALE

The Task Manager displays all running and failed jobs/processes.

TaskManagerSCALE

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.

TaskManagerHistorySCALE

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.

Alert Settings

The Alert Settings screen has options for setting the warning level and frequency for alerts specific to application actions.

AlertSettingsSCALE

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.

Alert Services

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.

AlertServicesSCALE

To create a new alert service, click Add and fill out the form, then click Save.

NewAlertServiceSCALE

Name and Type

SettingDescription
NameName of the new alert service.
EnabledUnset to disable this service without deleting it.
TypeChoose an alert service to display options for that service.
LevelSelect the level of severity.

Authentication

SettingDescription
AWS RegionEnter the AWS account region.
ARNTopic Amazon Resource Name (ARN) for publishing. Example: arn:aws:sns:us-west-2:111122223333:MyTopic.
Key IDAccess Key ID for the linked AWS account.
Secret KeySecret Access Key for the linked AWS account.

The SEND TEST ALERT button generates a test alert to confirm the alert service will work correctly.

Email

The Email screen has options for users to set up a system email address.

AlertEmailSCALE

SettingDescription
From EmailThe 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 NameThe friendly name to show in front of the sending email address. Example: Storage System 01it@example.com
SMTPEnable SMTP configuration.
GMail OAuthEnable GMail OAuth authentication.
Outgoing Mail ServerHostname or IP address of SMTP server to use for sending this email.
Mail Server PortMTP port number. Typically 25,465 (secure SMTP), or 587 (submission).
SecurityEmail encryption type. Choices are Plain (No Encryption), SSL (Implicit TLS), or TLS (STARTTLS).
SMTP AuthenticationEnable 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.

Change Password

Clicking Change Password allows users to change the currently logged-in administrator password.

Preferences

Clicking Preferences lets users select general preferences for the system.

WebInterfacePreferencesSCALE

SettingDescription
Choose ThemeChoose a preferred theme.
Prefer buttons with icons onlyPreserve screen space with icons and tooltips instead of text labels.
Enable Password ToggleWhen set, an eye icon appears next to password fields. Clicking the icon reveals the password.
Reset Table Columns to DefaultReset all tables to display default columns.
Retro LogoRevert branding back to FreeNAS.
Reset All Preferences to DefaultReset all user preferences to their default values (custom themes are preserved).

API Keys

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.

Guide and About

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.

The Power button lets the user log out of, restart, or shut down the system.

Storing Data

Now that you can access the TrueNAS web interface and see all the management options, it’s time to begin storing data!