5 minute read.Last Modified 2023-11-17 10:51 EST
Now that TrueNAS is installed, it’s time to log in to the web interface and begin managing data!
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 Method||Contact Options|
|Telephone||Monday - 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
|Telephone||After Hours (24x7 Gold Level Support only):|
US-only toll-free: 1-855-499-5131
International: 1-408-878-3140 (international calling
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: 192.168.1.1/24 Example 2 IP and Netmask separate: IP: 192.168.1.1 Netmask: 255.255.255.0, or /24 or 24 IPv4 Address: 192.168.1.108/24 Saving interface configuration: Ok Configure IPv6? (y/n) n Restarting network: ok ... The web user interface is at http://192.168.1.108
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.
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
pingreaches 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:
- 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.
The horizontal menu at the top of the web interface contains status indicators, system alerts, UI theme options, and system power options.
Across the top row are links to outside resources and buttons to control the system.
The options described from left to right:
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.
The remaining icons in the top menu show various statuses. They also provide system options.
The /> icon next to the iXsystems logo shows <a class=“gdoc-markdown__link” href=“https://www.truenas.com/truecommand/"
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.
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. Please back up or otherwise memorize the updated password when changing it.
Preferences contains theme and other visual options for the web interface:
|Choose Theme||Select 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 only||Select to preserve screen space using icons and tooltips instead of text labels.|
|Enable Password Toggle||Select to display an eye icon next to password fields. Clicking the icon reveals the password.|
|Reset Table Columns to Default||Select to reset all tables to display system default table columns.|
|Retro Logo||Select to revert branding back to FreeNAS.|
|Reset All Preferences to Default||Select to reset all user preferences to their default values. Preserves custom themes.|
|Update Preferences||Click to save changes to the General Preferences.|
Create and manage custom themes on this screen.
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.
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’s time to begin storing data!