This repository has been archived on 2024-04-14. You can view files and clone it, but cannot push or open issues or pull requests.
help-center-docs/troubleshooting/boot-rescue/en.md

3.9 KiB

+++ title = "Boot Rescue" lastmod = "2017-09-22T20:08:14+03:00" aliases = ["/articles/configuration/modifying-grub/en/", "/articles/repair-and-recovery/boot-rescue/en/"] +++

Boot Rescue

In this document, we will walk through restoring the ability to boot Solus.

The inability to boot Solus can be attributed to various issues, such as:

  • Multi-booting with an other operating system that "owns" GRUB and fails to show Solus after an upgrade of Solus is performed.
  • Upgrades, such as to the kernel, that may not have applied correctly. In which case this could affect "legacy boot" (non-UEFI) or UEFI systems.

Multi-Booting

Multi-booting is when you have multiple operating systems on the same device. Also referred to as "dual-booting" when only having two operating systems on the same device.

The inability to access Solus in a multi-boot scenario typically applies to "legacy boot" (non-UEFI), where the other operating system owns GRUB, which is used booting itself and Solus. This can be resolved by accessing the other operating system and running sudo update-grub.

Incorrectly Applied Updates

In the case that updates have not been applied correctly by the system or the updates were interrupted, it may be possible to boot rescue the Solus system. To do so, you will need:

  1. A Live ISO of Solus booted on your system
  2. A terminal in that Live ISO opened

Mounting your system

Whether you're using GRUB or UEFI, you will need to mount your Solus root (/) partition as the first step of performing a boot rescue. This is typically your primary partition, formatted as the filesystem type ext4.

  1. First we need to be root as the user. Type: sudo su
  2. Next we make a directory where we will mount our local Solus system: mkdir /target
  3. Now, using lsblk, determine the /dev/sdX# partition of the Solus system. We recommend checking the size of the partition listed and if it matches the size of your Solus install, use that. It will likely be something along the lines of /dev/sdb# or /dev/sda#.
  4. Once found, replace the "sdX#" in the following command with the partition and mount to the target directory we created: mount /dev/sdX# /target

UEFI

If your system uses UEFI as opposed to GRUB, you will also need to mount your EFI System Partition, otherwise referred to as ESP. If you followed our UEFI guide during installation of Solus, then in all likelihood your ESP will be about 500mb in size. If you're unsure of the partition, run the following, replacing X with the same letter during your mounting of your root file system, minus the number:

fdisk -o Device,Size,Type -l /dev/sdX

Your output may look something similiar to:

Device       Size Type
/dev/sda1    512M EFI System
/dev/sda2  111.3G Linux filesystem

Notice we have /dev/sda1 as the Device with the EFI System type and roughly 500mb in size. This is the partition we will be mounting.

With our ESP device known, let's go ahead and mount it, replacing sdX# in the case below with our partition.

mount /dev/sdX# /target/boot

Chrooting to your Solus system

To access your system and perform boot rescue, you will need to mount specific directories from the host system (in this case, our Live ISO), to our Solus system, and then chroot (change root) to the Solus system.

First run the following commands:

mount --bind /proc /target/proc
mount --bind /dev /target/dev
mount --bind /run /target/run
mount --bind /sys /target/sys

Assuming all goes well, you should now be able to chroot into your Solus system by doing chroot /target

Once in the chroot, run the following command, which will generate the necessary GRUB configuration files, EFI loader files, etc.

sudo clr-boot-manager update

After this, you should exit your chroot with exit then reboot your system. In the event you are still unable to access Solus, please contact us.