.. include:: /urls.rst

.. _pureboot_upgrade:

Upgrade or convert to PureBoot
==============================

This guide will walk you through the process of upgrading PureBoot or switching coreboot->PureBoot on a Librem 14.

.. raw:: html

    <video width="80%" controls>
        <source src="https://videos.puri.sm/promo/pureboot_upgrade.mp4" type="video/mp4">
        <source src="https://videos.puri.sm/promo/pureboot_upgrade.webm" type="video/webm">
        Your browser does not support HTML video.
    </video>

:download:`Download <https://videos.puri.sm/promo/pureboot_upgrade.mp4>`


Upgrading PureBoot
------------------

Purism occasionally releases new PureBoot firmware.
You can update PureBoot firmware directly from PureBoot itself!

To update to a newer version of PureBoot:

.. Previous instruction: Get the latest version of the PureBoot firmware for your hardware, either directly from our `coreboot releases`_ or by running our `coreboot utility`_.

#. Download the new PureBoot ROM from our `PureBoot release repository`_ for your corresponding hardware.
#. Copy that to a USB thumb drive and attach it to your Librem device.
#. Power on your Librem device and enter the PureBoot settings by pressing the **Escape** key.
#. Head to **Options** -> **Flash or update the BIOS** -> **Flash the firmware with a new ROM and retain BIOS settings**.
#. Next, select your USB device, then select the ROM file.
#. Select **yes** to proceed.
#. Your BIOS will update and your computer will reboot once done.

.. note::
   You will receive a notification to update your TOTP/HOTP secret during the subsequent boot after updating the firmware.


.. _pureboot_convert_from_coreboot:

Convert from coreboot to PureBoot
---------------------------------

This utility can be used to flash the firmware if the system currently runs coreboot.

#. Open a terminal.
#. Run these commands:

   .. code-block:: bash

       mkdir ~/updates
       cd ~/updates
       wget https://source.puri.sm/coreboot/utility/raw/master/coreboot_util.sh -O coreboot_util.sh
       sudo bash ./coreboot_util.sh

#. Enter your root password.
#. Enter a **1** to select **Update firmware using pre-built image**.
#. The script will prompt you for your device model; enter your device's corresponding number.
#. Select PureBoot as the firmware to be flashed.
#. Choose the default option to extract if asked to update the serial number.
#. Once flashed, you should attach your Librem key, reboot, and follow the setup guide.