TrueNAS CORETrueNAS CORE Nightly Development Documentation
This content follows experimental early release software. Use the Product and Version selectors above to view content specific to a stable software release.

Logging In

Now that TrueNAS is installed, it’s time to log in to the web interface and begin managing data!

Can I configure TrueNAS using a CLI? After installing TrueNAS, configuring and using the system is all managed through the web interface. It is important to only use 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. Any changes made in the command line are lost and reverted to the original database settings whenever the system restarts. TrueNAS automatically creates a number of ways to access the web interface, but you might need to adjust the default settings to better fit the system in your network environment.

Web Interface Access

By default, TrueNAS provides a default address for logging in to the web interface. To view the web interface IP address or reconfigure web interface access, you will need to 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 and provide access to the web interface. On networks that support Multicast Domain Name Services (mDNS), a hostname and domain can be used to access the TrueNAS web interface. By default, TrueNAS is configured to use the hostname and domain truenas.local You can change this after logging in to the web interface by going to Network > Global Configuration and setting a new Hostname and Domain.

If an IP address is needed, connect a monitor to the TrueNAS system and view the console setup menu that displays at the end of the boot process.


When able to automatically configure a connection, the system shows the web interface IP address at the bottom of the console setup menu. If needed, you can reset the root password in the TrueNAS console setup menu or by clicking Settings > Change Password in the web interface. To require logging in to the system before showing the system console menu, go to System > Advanced and unset Show Text Console without Password Prompt.

TrueNAS Enterprise hardware from iXsystems is preconfigured with your provided networking details. The IP address of the TrueNAS web interface is provided on the system sales order or configuration sheet. Please contact iX Support if the TrueNAS web interface IP address has not been provided with these documents or cannot be identified from the TrueNAS system console.

Customers who purchase iXsystems hardware or that want additional support must have a support contract to use iXsystems Support Services. The TrueNAS Community forums provides free support for users without an iXsystems Support contract.

Contact MethodContact Options
TelephoneMonday - Friday, 6:00AM to 6:00PM Pacific Standard Time:

US-only toll-free: 1-855-473-7449 option 2
Local and international: 1-408-943-4100 option 2
TelephoneAfter Hours (24x7 Gold Level Support only):

US-only toll-free: 1-855-499-5131
International: 1-408-878-3140 (international calling
rates apply)

If the TrueNAS system is not connected to a network with a DHCP server, you can use the console network configuration menu to manually Configure Network Interfaces.


This example shows configuring a single interface, em0:

Enter an option from 1-12: 1
1) em0
Select an interface (q to quit): 1
Remove the current settings of this interface? (This causes a momentary disconnec
tion of the network.) (y/n) n
Configure interface for DHCP? (y/n) n
Configure IPv4? (y/n) y
Interface name:     (press enter, the name can be blank)
Several input formats are supported
Example 1 CIDR Notation:
Example 2 IP and Netmask separate:
    Netmask:, or /24 or 24
IPv4 Address:
Saving interface configuration: Ok
Configure IPv6? (y/n) n
Restarting network: ok


The web user interface is at

Depending on the network environment, review the Configure Default Route option to define your IPv4 or IPv6 default gateway. Configure Static Routes allows adding destination network and gateway IP addresses, one for each route. To change the DNS domain and add nameservers, select Configure DNS.

These settings can be adjusted later in the various Network options available in the web interface.

Logging In

On a computer that can access 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.

The quality of your user experience can be impacted by the browser that you use. We generally recommend using Firefox, Edge, or Chrome.


Enter the administrative account credentials to log in. By default, the administrative account username is root and the password is set when installing TrueNAS.


If the user interface is not accessible by IP address from a browser, check these things:

  • Are proxy settings enabled in the browser configuration? If so, disable the settings and try connecting again.
  • If the page does not load, make sure that a ping reaches the TrueNAS system IP address. If the address is in a private IP address range, it is only accessible from within that private network.

If the web interface is shown but seems unresponsive or incomplete:

  • Make sure the browser allows cookies, Javascript, and custom fonts from the TrueNAS system.
  • Try a different browser. Firefox is recommended.

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, the TrueNAS web interface present options across the top and left side of the screen.

Top Menu

The horizontal menu at the top of the web interface contains status indicators, system alerts, UI theme options, and system power options.

Top Menu Details

Across the top row are links to outside resources and buttons to control the system.


The options described from left to right:

Click the links above to jump to the sections with details on these top toolbar options.

Logos and Side Panel Controls

The logo in the upper-left corner shows the installed TrueNAS software. Clicking the image takes you to the system Dashboard.

The next two buttons control how the side menu displays. Click the (menu icon) to hide or show the entire left side panel. Click the (chevron left icon) to collapse the left side panel to shortcut icons or expand to show icons and text.

Click the iXsystems logo to open the iXsystems corporate website in a new browser tab.

Status Icons

The remaining icons in the top menu show various statuses. They also provide system options.

The TrueCommand Logo icon next to the iXsystems logo shows TrueCommand Cloud connection options. Clicking the icon shows options for signing up for TrueCommand Cloud. It also displays options for connecting/disconnecting from TrueCommand Cloud. When the system is not connected to TrueCommand Cloud the options are not available. The icon appears but is gray in color.

TrueNAS Enterprise compatible hardware has a (cloud with HA text) icon that shows the current status of High Availability (HA) on the system. A checkmark () cloud icon indicates HA is functional. An on top of the cloud icon indicates HA disabled or otherwise unavailable.

Task Manager

The (clipboard icon) is the system Task Manager. Click the icon to show a list of running or completed TrueNAS tasks. Tasks are sortable by their success or error State, task Method, and Progress. Typing text in the Filter field shows tasks that match the characters typed into the field. Clicking an entry shows more details about that task. This includes start and end timestamps.


The (bell icon) contains system notification messages. The icon changes to when TrueNAS creates a new alert. Clicking the icon slides out a panel from the right side of the screen that lists each alert. Dismiss or reopen alerts in this panel. Dismissing an alert does not prevent it from recurring. TrueNAS might create a new alert if the alert conditions continue to exist on the system. Configure the alert system in System > Alert Settings.


The (gear icon) contains links to various system specific options.

Change Password is a shortcut for changing the administrator (root) account password. Password required to log in to the TrueNAS web interface. Back up or otherwise memorize the updated password when changing it.

Preferences contains theme and other visual options for the web interface:

Preferences Options
Choose ThemeSelect a preferred theme from the dropdown list. There are several built-in themes designed for light and dark modes. High contrast viewing options of the web interface are also listed.
Prefer buttons with icons onlySelect to preserve screen space using icons and tooltips instead of text labels.
Enable Password ToggleSelect to display an eye icon next to password fields. Clicking the icon reveals the password.
Reset Table Columns to DefaultSelect to reset all tables to display system default table columns.
Retro LogoSelect to revert branding back to FreeNAS.
Reset All Preferences to DefaultSelect to reset all user preferences to their default values. Preserves custom themes.
Update PreferencesClick to save changes to the General Preferences.

Click Create New Theme on this screen to create and manage custom themes.

API Keys opens the API Keys screen where you can create or view API keys on the system. Click Add to create a new API key. Click Docs to open the API documentation for the current release.

About opens the TrueNAS CORE looking for help widget. This same widget is available on the system Dashboard, and provides links to the TrueNAS Documentation, community forum, TrueNAS CORE Enterprise web sites.


The (power icon) has the options for changing the system state.

Log Out exits the web interface and shows the login screen. The system remains powered on.

Restart initiates a power cycle. The web interface closes. Discontinues power to the system which is then re-enabled. The login screen appears when the boot cycle completes.

Shut Down exits the web interface. The process to safely discontinue power to the system begins. The system remains offline until the power situation corrects.

Side Menu

The column on the left side of the screen contains some information about the system and links to the various TrueNAS configuration screens. The box at the top of the columns shows the current logged in user account and the system host name.

Configuration screens are organized by feature. For example, to find options related to storing data, click the Storage option and to make data stored in TrueNAS available to client systems, go to the Sharing section.


The system Dashboard is the default screen when logging in to TrueNAS. Basic information about the installed version, systems component usage and network traffic are all presented on this screen. For users with compatible TrueNAS Hardware, clicking the system image goes to the System > View Enclosure page.


The Dashboard provides access to all TrueNAS management options.

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