Facing startup issues with your machine is enough to ruin your day. Whether due to hardware/software issues or simply a human error, startup issues can be frustrating and time-consuming to fix. Luckily, the Ubuntu Boot Repair tool is just right around the corner.
In this tutorial, you will learn to install and fix startup issues on your Ubuntu system in a few clicks so you can get back to business.
Read on to save yourself the headaches of fixing startup issues!
Prerequisites
This tutorial comprises hands-on demonstrations. You will need a bootable USB drive with Ubuntu installed to follow along. This tutorial uses Ubuntu 20.04 LTS (Focal Fossa).
Installing the Ubuntu Boot Repair Tool
The Ubuntu Boot Repair tool lets you repair frequent startup issues in Ubuntu with one click — talk about convenience. But like other packages, the Ubuntu Boot Repair tool is not preinstalled in your system.
Before installing Ubuntu Boot Repair, you must first add the tool’s Personal Package Archive (PPA) repositories. A PPA is a repository that provides access to software packages that are not part of the official Ubuntu repositories.
PPAs are maintained by individuals or groups and are not affiliated with the official Ubuntu repositories.
To install the Ubuntu Boot Repair tool on your system, follow these steps:
1. First, plug in your bootable USB drive and boot into the OS.
2. Next, select Try Ubuntu to boot into the live environment without actually installing the OS. Doing so allows you to use Ubuntu without making changes to your computer’s hard drive.
3. Once in the live environment, open a terminal and run the add-apt-repository
command to add the PPA repositories for Ubuntu Boot Repair.
While most PPAs are safe to use, some may contain malicious software or packages that could compromise the security of your system. Before adding a PPA to your system, you should carefully review the PPA’s website and make sure that it is from a reputable source.
sudo add-apt-repository ppa:yannubuntu/boot-repair
Press Enter when prompted to confirm the addition of the PPA.
4. Now, run the below apt update
command to update your package list.
This command retrieves a list of the latest versions of packages and their dependencies from the configured repositories. One of these packages is the official Ubuntu repository or the PPA repositories you added.
sudo apt update -y
5. After the update, run the following cat
command to verify that the contents of the PPA repository list file were added.
cat /etc/apt/sources.list.d/*yannubuntu*.list
If the repositories were added successfully, you should see the PPA’s URL listed in the file, as shown below.
6. Next, run the below apt-cache
command to list the following:
- Ubuntu Boot Repair’s (
boot-repair
) version is available in the PPA repository and its dependencies.
- The repositories (if any) Boot Repair can be installed from.
sudo apt-cache policy boot-repair
With the PPA repositories successfully added, you can install Boot Repair on your system. PPAs allow you to accomplish the following:
- Install and update software that is not available in the official repositories
- Install newer software versions that are not yet available in the official repositories.
7. Now, run the apt install
command below to install the latest Ubuntu Boot Repair (boot-repair
) version and its dependencies. sudo
sudo apt install -y boot-repair
8. Lastly, run the below boot-repair
command to launch the Ubuntu Boot Repair tool.
boot-repair
The first time you run the Boot Repair tool, it scans your system and checks all the available boot options, so be patient while the process runs.
Once the scanning is finished, the tool’s main interface appears, as shown below. This interface provides several options for troubleshooting and repairing boot issues, which you will learn in the following sections.
Fixing Startup Issues with Boot Repair
Now that you have Boot Repair running, fixing startup issues in your system is only one click away (literally). In most cases, you will want to select Boot Repair’s recommended repair option to attempt to detect and fix any boot issues on your system automatically.
To fix startup issues via the Boot Repair, follow these steps:
1. On Boot Repair’s main window, click Recommended repair to begin the repair process.
The Boot Repair tool repairs any startup issues on your system; it reinstalls the bootloader (e.g., GRUB), repairs the boot sector of a specific partition, and so on.
The repair may take a while, depending on the issue’s severity.
2. Once the repair completes, click OK when you see a message similar to the one below.
3. Now, unplug your bootable USB drive, reboot your machine, and verify that the boot issue is fixed. You can now boot into Ubuntu without any problems.
Boot Repair is designed to fix common boot issues, but it may not be able to fix “every” issue. If the recommended repair option does not fix the issues, you may need help from the community or a professional.
Using Advanced Options and Creating a BootInfo Report
Besides the recommended repair option, the Ubuntu Boot Repair tool allows you to manually repair specific boot issues or configure your boot options. You can find and play these options under the Advanced options section and create a BootInfo report.
1. Expand Advanced options on Boot Repair’s main window to see all available options you can configure for repairing startup issues.
Below are some examples, but are not limited to, of advanced options that you may find in the Ubuntu Boot Repair:
- Reinstall the bootloader (e.g., GRUB).
- Back up/restore the EFI files.
- Repair the filesystem.
2. Close the Advanced options section, and click Create BootInfo Summary to create a report of your system’s boot configuration. You can then share the BootInfo report with experienced helpers to get assistance with your boot issues.
The BootInfo report contains detailed information about your system’s boot configuration, including the following:
- A summary of the boot entries and the bootloader (e.g., GRUB).Any errors or issues the tool encountered while trying to repair the boot issues (if any).
Boot Repair now generates a report of your boot configuration.
3. When prompted, select Yes to upload the report to Ubuntu Pastebin. Ubuntu Pastebin is a popular website for sharing text or code and provides a link to it. That link comes in handy when seeking help from the community or professional.
If you select No, the report is saved locally in the /var/log/boot-repair directory.
4. Finally, copy the link printed on the message box, and share it with your fellow community members or professionals to get help with your boot issues.
If you saved the BootInfo report file locally, run the following commands to list (ls
) all report files and view (cat
) the content of one.
ls -l /var/log/boot-repair
cat /var/log/boot-repair/20230106_135919/boot-repair.log
Conclusion
Fixing boot issues on your Linux system can be challenging, but you can never go wrong with the Ubuntu Boot Repair tool. And in this tutorial, you learned how this powerful tool could quickly fix common boot problems, saving you time and frustration.
If, for some reason, startup issues persist, Boot Repair lets you generate a shareable BootInfo report so the community and professionals can help out.
But when working on an Amazon EC2 Linux instance, why not check out EC2Rescue for Linux to troubleshoot OS-level issues?