How to roll back to previous version of TrueNAS

TrueNAS rollback option

On TrueNAS, you can quickly roll back to a previous version of the operating system after installing an update or upgrading to a new release, and in this guide, you will learn how.

Whenever you install an update or upgrade to a new release of TrueNAS, the server doesn’t modify the current installation. Instead, it downloads and creates a new setup with the same settings and stores it as a “boot environment,” which you can use to switch back to a previous installation.

This guide will teach you the steps to undo an update, roll back to a previous version, or uninstall a newer release of TrueNAS Core.

Roll back to previous version of TrueNAS

To rollback to a previous version of TrueNAS, use these steps:

  1. Open TrueNAS (web).

  2. Click on System from the left pane.

  3. Click on Boot.

  4. Under the “Boot Environments” section, click the menu (three-dot) button and select the Active option for the previous installation of TrueNAS to roll back.

    TrueNAS rollback option

  5. Click the Confirm option.

  6. Click the Activate button.

  7. Click the Power button and select the Restart option from the top-right corner.

    TrueNAS restart

  8. Click the Confirm option.

  9. Click the Active button.

Once you complete the steps, the server will restart, and TrueNAS will boot using the previous setup after installing an update from the same release or upgrading to a new version of the operating system.

It’s important to note that you may find multiple setups that you can use to roll back. The “default” is the original installation, and every installation after that will carry the version as the name.

If you are rolling back due to issues, you can permanently remove the setup (boot environment) from System > Boot, check the installation, and click the “Delete” button.

You will also notice the “Clone” option. If you want to make test changes without affecting the main installation of TrueNAS, you can create a clone of the system. Once you have tested the new modifications, you switch back setups safely. You can easily roll back to the previous setup if you encounter problems.