TrueNAS Nightly Development Documentation
This content follows experimental nightly development software. Pre-release software is intended for testing purposes only.
Use the Product and Version selectors above to view content specific to a stable software release.

Boot

4 minute read.

Last Modified 2024-11-15 12:12 EST

The System > 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 Actions

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

Setting	Description
Stats/Settings	Opens 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 Status	Opens 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 Pool	Opens the Scrub dialog. Performs a manual data integrity check (scrub) of the operating system device.

Boot Pool Status

The System > 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.

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.

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 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.

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.

Action	Boot State	Description
ActivateActivate	Deactivated	Opens 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.
CloneClone	Both states	Opens 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.
RenameRename	Both states	Opens the Rename Boot Environment window. Enter a new name using only alphanumeric characters, and/or the allowed dashes (-), underscores (_), and periods (.) characters.
DeleteDelete	Deactivated	Opens 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.
KeepKeep	If set to false	Opens 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.
UnkeepUnkeep	If Keep is set to True	Opens 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.