Post-install Configuration
4 minute read.
Last Modified 2022-04-26 14:02 EDTThe Console Setup menu displays at the end of the boot process. If the TrueNAS system has a keyboard and monitor, you can use this menu to administer the system.
By default, TrueNAS doesn’t display the Console Setup menu when you connect via SSH or the web shell.
The root
user or another user with root permissions can start the Console Setup menu by entering /etc/netcli
.
The menu provides these options:
Configure network interfaces provides options to set up network interfaces.
Reset root password resets the
root
user password.Reset configuration to defaults resets the system to default settings.
Open TrueNAS CLI Shell starts a shell for running TrueNAS commands. Type
exit
to leave the shell.Open Linux Shell starts a shell for running Linux commands. Type
exit
to leave the shell.Reboot reboots the system.
Shut Down shuts down the system.
Console Setup menu options may change with software updates, service agreements, etc.
During boot, TrueNAS attempts to connect to a DHCP server from all live interfaces.
If it receives an IP address, the Console Setup menu displays it so you can access the Web UI.
In the picture above, the TrueNAS web UI is at 10.0.2.15
.
You may be able to access the web UI using hostname.domain
(default is truenas.local
) if your system:
- Doesn’t have a monitor.
- Is on a network that supports Multicast DNS (mDNS).
Enter 4
to open the TrueNAS CLI Shell.
Enter
network interface
, then enterquery
to display available physical system interfaces.Once you know which interface you want to update, enter
update interface aliases=["ipaddress"] ipv4_dhcp=false
.
Example:update eno1 aliases=["10.0.2.15"] ipv4_dhcp=false
Enter
commit
to apply the pending changes.Enter
checkin
, then enterquery
to show the updated interfaces.
Enter
..
to go back to thenetwork>
prompt, then enterconfiguration
.Enter
update ipv4gateway="ipaddress"
. After you execute the command, the Console Setup menu displays the new web UI address.
Example:update ipv4gateway="10.0.2.15"
- Enter
exit
to go back to the Console Setup menu.
Enter
4
to open the TrueNAS CLI Shell.Enter
network interface
, then enterquery
to display available physical system interfaces.Once you know the interface names, enter
create type=LINK_AGGREGATION lag_ports=["interface1","interface2"] lag_protocol=LACP
Example:network interface create type=LINK_AGGREGATION lag_ports=["eno1","eno2"] lag_protocol=LACP
- Enter
create type=VLAN vlan_parent_interface=bond# vlan_tag=#### aliases=[{"address": "ipaddress", "netmask": "bitlength"}]
Example:create type=VLAN vlan_parent_interface=bond0 vlan_tag=1022 aliases=[{"address": "10.0.2.15", "netmask": "32"}]
Enter
commit
to apply the pending changes.Enter
exit
to return to the Console Setup menu.Enter
5
to open the Linux Shell, then enterip addr show
to ensure you set the correct IP address.Enter
exit
to go back to the Console Setup menu.
Enter
4
to open the TrueNAS CLI Shell.Enter
network configuration update ipv4gateway="ipaddress"
Example:network configuration update ipv4gateway="10.0.2.15"
Enter
exit
to go back to the Console Setup menu.Enter
5
to open the Linux Shell.Enter
ping ipaddress
to ping the gateway.
Example:ping 10.0.2.15
When you are ready to stop pinging, type Ctrl+C to view the statistics.
- Enter
exit
to go back to the Console Setup menu.
Enter
4
to open the TrueNAS CLI Shell, then enternetwork interface
Enter
update interface1 aliases="ipaddress"
Example:update eno1 aliases="10.0.2.15"
Enter
commit
, thencheckin
to apply the changes.Enter
exit
to go back to the Console Setup menu.
Enter 2
in the Console Setup menu, then enter and re-enter the new password you want to use.
Changing the root password disables 2FA (Two-Factor Authentication).
Enter 3
in the Console Setup menu, then enter y
to reset the system configuration. The system will reboot and revert to default settings.
Caution! Resetting the configuration deletes all settings and reverts TrueNAS to default settings. Before resetting the system, back up all data and encryption keys/passphrases! After the system resets and reboots, you can go to Storage and click Import to re-import pools.