This guide explains how to fix a broken installation of Clear Linux OS using a live desktop image on a USB. It’s assumed you already installed Clear Linux OS on a target system, but your operating system does not boot or function properly.

This process can only verify and fix files that swupd owns in /usr. Files outside of this path, such as /home/, /etc, /var, etc., cannot be repaired by this process.

Boot a live desktop image to fix target system

  1. Boot the Clear Linux OS live desktop image.

Install from live image

After you download and burn the live desktop image on a USB drive, follow these steps.

  1. Insert the USB drive into an available USB slot.

  2. Power on the system.

  3. Open the system BIOS setup menu by pressing the F2 key. Your BIOS setup menu entry point may vary.

  4. In the setup menu, enable the UEFI boot and set the USB drive as the first option in the device boot order.

  5. Save these settings, e.g. F10, and exit.

  6. Reboot the target system.

  7. Select Clear Linux OS in the boot menu, shown in Figure 1.

    Clear Linux OS in boot menu

    Figure 1: Clear Linux OS in boot menu

Mount root partition, verify, and fix

  1. Open a Terminal window.

  2. Assure the system is connected to the network.

  3. Mount the system’s root partition.

    1. To find the root partition, run:

      lsblk
      

      We’ll use /dev/sda3/ as the root partition example.

    2. Next, mount the partition to the /mnt folder.

      sudo mount /dev/sda3 /mnt
      
  4. Verify that you mounted the correct root partition by checking for some files commonly found on Clear Linux OS systems.

    cat /mnt/usr/lib/os-release
    ls /mnt/usr/share/clear/bundles
    
  5. Next, run swupd to fix any issues on the target system.

    sudo swupd repair --picky --path=/mnt
    

    Learn more about how swupd works.

  6. After the process is complete, unmount the root partition:

    sudo umount /mnt
    
  7. Reboot the system, remove the live desktop USB drive, and boot into the repaired system.

    sudo reboot
    

Congratulations! You successfully restored Clear Linux OS.