Recovery modes

Recovery modes

The following recovery functions are currently available:

  • Run mode: restarts normally and runs the boot process
  • Install mode / factory mode: initialise the device from an onboard system image
  • Recover mode: reboot into recovery mode for data retrieval
  • Factory reset: erase all data and initialise the device to its original stage

See Using recovery modes for details on how these modes are accessed.

Run mode

When booting in run mode, the device will attempt to boot normally, with no further option to recover or reinstall the system unless the recovery process is reinstantiated.

Install mode

With install mode, all existing user data on the device will be removed and the device will be initialised from the system version image dated and listed in the reinstall text.

After the re-initialisation process has completed, you will need to step through the installation process of network configuration and account credentials again.

See Installation steps for further details on how the installation will proceed.

TPM provision failures:
Re-installation can fail if a device’s TPM is assigned to a previous installation. To solve this issue, reset or clear the TPM assignment from the device’s BIOS before selecting reinstall as a recovery mode.

Recover mode

In recovery mode, the device operates as it would from a pristine initial installation, including its snaps, via a temporary file system.

Most importantly, however, the running system data is untouched. This allows you to log in to the system using prior credentials to recover your data, either via SSH or locally after setting up a password for the user.

Rebooting from recovery mode will return the system to run mode.

Factory reset

The factory reset option will erase all data and reset the device to its original state.

This is a dangerous option and should only be performed when you are certain the data on a device data is either backed-up or unwanted.

1 Like

“After has bee initiated …” Not sure what this should say.

Thanks for flagging this. I’ve updated the text.

This page will also need a reference to “factory-reset” recovery mode.

Thanks for the reminder! We’re still working on parts of the factory reset feature, but I’ll make sure we update this page when the feature lands and we have its wider documentation in place.