TrueNAS SCALETrueNAS SCALE 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.


The System Settings > Boot screen contains options for monitoring and maintaining the TrueNAS install pool and disks. This includes managing OS restore points, called boot environments, for the TrueNAS system.

System Boot Screen
Figure 1: System Boot Screen

System Boot Actions

The System Settings > Boot screen displays four options at the top right of the screen.

Stats/SettingsOpens the Stats/Settings window with the Boot pool Condition, Size and Used, and Last Scrub Run statistics for the operating system device, and provides the option to change the default duration between the operating system device scrubs from every 7 days to a new duration in days.
Boot Pool StatusOpens the Boot Pool Status screen that displays the status of each device in the operating system device (boot pool), options for managing boot-pool devices, and lists any read, write, or checksum errors.
Scrub Boot PoolOpens the Scrub dialog. Performs a manual data integrity check (scrub) of the operating system device.

Boot Pool Status

The System Settings > Boot > Boot Pool Status screen shows the status of the current boot-pool. It includes the current status, the path, and the number of read, write and checksum errors.

Boot Pool Status
Figure 2: Boot Pool Status

The vertical ellipsis next to a device displays two options, Attach or Replace.

Attach Screen

The boot status Attach screen settings specify a device as the disk member and how much of the device is used.

Boot Status Attach
Figure 3: Boot Status Attach

Select a device from the Member Disk dropdown.

Select Use all disk space to use the entire capacity of the new device.

Replace Screen

Replace settings specify a replacement device from the Member Disk dropdown.

Boot Status Replace
Figure 4: Boot Status Replace

Boot Environments

Each time the system updates to a new software release, it creates a new boot environment. You can also clone an existing boot environment to create an operating system restore point.

Each boot environment on the list includes:

  • Name which is the name of the boot entry as it appears in the boot menu.
  • Active that indicates which entry boots by default if a boot environment is not active. Activated environment displays Non/Reboot.
  • Date Created that shows the creation date and time.
  • Space shows the boot environment size.
  • Keep that indicates whether TrueNAS deletes this boot environment when a system update does not have enough space to proceed.

Batch Operations

Select the checkbox(es) for each boot environment. Displays the Batch Operations that allows you to delete the selected environments at one time.

Batch Operations Boot Screen
Figure 5: Batch Operations Boot Screen

The vertical ellipsis displays a list of boot environment actions that change based on whether it is activated or not.

Boot Environment Actions Lists

The vertical ellipsis for an environment displays actions available to that environment.

ActionBoot StateDescription
ActivateActivateDeactivatedOpens the Activate dialog. Changes the System Boot screen status to Reboot and changes the current Active entry from Now/Reboot to Now, indicating that it is the current boot environment but is not used on next boot.
CloneCloneBoth statesOpens the Clone Boot Environment window. Copies the selected boot environment into a new entry. Enter a new name using only alphanumeric characters, and/or the allowed dashes (-), underscores (_), and periods (.) characters.
RenameRenameBoth statesOpens the Rename Boot Environment window. Enter a new name using only alphanumeric characters, and/or the allowed dashes (-), underscores (_), and periods (.) characters.
DeleteDeleteDeactivatedOpens the Delete dialog. Does not display if the boot environment is activated/ You cannot delete the default or activated boot environment. Removes the highlighted entry and also removes that entry from the boot menu.
KeepKeepIf set to falseOpens the Keep dialog, and toggles the boot environment action to Unkeep. Use to prevent the TrueNAS updater from automatically deleting the environment to make more space for a new environment when there is insufficient space for it.
UnkeepUnkeepIf Keep is set to TrueOpens the Unkeep dialog, and toggles the boot environment action to Keep. Use to allow TrueNAS updater to automatically delete the environment to make space for a new boot environment when there is not enough space for it.