(408) 943-4100               V   Commercial Support

Shell

  2 minute read.

Last Modified 2021-04-02 11:30 EDT

The web interface has a web shell that makes it convenient to run command line tools from the web browser as the root user.

UIShell

The prompt shows that the current user is root, the hostname is freenas, and the current working directory is ~, the home directory of the logged-in user.

The default shell for a new installations is zsh.

The default shell can be changed in Accounts > Users. Click and Edit for the root user.

AccountsUsersEditRootShell

Choose the desired shell from the Shell drop-down and click SAVE.

The Set font size slider adjusts the size of text displayed in the Shell. Click RESTORE DEFAULT to reset the shell font and size.

Shell command history is available for the current session. Use the Up and Down arrow keys to scroll through previously entered commands. Edit the command if desired, then press Enter to re-enter the command. Navigating away from the Shell screen clears the command history.

Home, End, and Delete keys are supported. Tab completion is also available. Type a few letters and press Tab to complete a command name or filename in the current directory. Right-clicking in the terminal window displays a reminder about using Command+c and Command+v or Ctrl+Insert and Shift+Insert for copy and paste operations in the shell.

Entering exit leaves the session. Click Reconnect to start a new session.

Clicking other web interface menus closes the shell session and stops commands running in the shell. tmux provides the ability to detach shell sessions and then reattach to them later. Commands continue to run in a detached session.

Not all shell features render correctly in Chrome. Firefox is the recommended browser when using the shell.

Most FreeBSD command line utilities are available in the Shell, including additional troubleshooting applications for TrueNAS Core and Enterprise.
For TrueNAS SCALE, most Linux command line utilities are available in the shell.