MX Boot Repair is a GUI app that can be used to recover from boot failure.
+MX Boot Repair is a GUI app that can be used to recover from boot failure.
-This app’s selection for “Install on” (see below) in the “Reinstall GRUB bootloader on ESP, MBR or PBR (root)” is not to be assumed as automatically correct at all times.
- -At times, with a very complex PC configuration there may need to be change(s) made to better match the PC under repair.
+This application’s selection for “Install on” (see below) in the “Reinstall GRUB bootloader on ESP, MBR or PBR (root)” is not to be assumed as automatically correct at all times. With a very complex PC configuration there may need to be change(s) made to better match the PC under repair.
-
The best starting point is to live-boot from a recent USB, and select “Repair GRUB configuration file”.
-Repair Grub configuration file is the most common use of this app. It should always be attempted first. Running just the “Repair GRUB configuration file” assumes that Grub is fully and properly installed in the expected location. Sometimes running a “Reinstall Grub bootloader” is needed to be done first, before Repair Grub configuration file.
@@ -37,9 +36,9 @@Example at below of a One Time Boot Menu. Choose the option ▸UEFI Boot Sources or Legacy Boot Sources depending on how Linux was installed. If you know that the PC’s Linux installation was in Legacy mode then pick “Legacy Boot Sources”. Other PCs screens may vary.
+Example at below of a One Time Boot Menu. Choose the option ▸UEFI Boot Sources or Legacy Boot Sources depending on how Linux was installed. If you know that the PC’s Linux installation was in Legacy mode then pick “Legacy Boot Sources”. Other PCs screens may vary.
-
Below is a view of a Windows hard disk layout prior to any partitions being labeled.
-
+Partitions above explained:
+sda1 – EFI aka ESP. Can be FAT32 or Vfat. Size ranges from 25-300 MiB. MX default is 256 MiB.
sda2 – “Windows Resources” Normally hidden in Windows File Manager. No format is normal.
@@ -78,9 +78,9 @@It is preferred to power OFF the PC, and then power on the PC back ON. This is because with a normal reboot will not clear all EFI stuff from RAM. Sometimes the MX Installer misses generating entries for other previously installed OS’s, so run in terminal:
-sudo update-grubsudo update-grubThis is a good check, to see anything was missed.
+This is a good check, to see if anything was missed.
2. Select: ◉ Repair GRUB configuration file. Click ‘→ Next’.
3. On the ‘Select GRUB location‘ screen in ‘Select root location:’ choose the MX Linux / root partition.
-
4. Click ‘✔Apply’.
5. In the ‘Authenticate‘ pop-up enter ‘demo’ for the ‘Password:’ prompt and click ‘Authenticate’.
6. A pop-up appears: ‘The GRUB configuration file (grub.cfg) is being rebuilt’.
7. When ‘Success‘ popup asks: ‘Do you want to exit MX Boot Repair?’ click ‘✔Yes’.
-You MUST be booted in UEFI mode to repair a UEFI installation with this app.
-Note: in the image below “EFI-SYSTEM” and “MX25Xfce” are partition labels are displayed as hints for your choices.
-1. Boot MX Linux USB in UEFI mode. Run MX Boot Repair.
-2. Select: ‘◉ Reinstall GRUB bootloader on ESP, MBR or PBR (root)’. Click ‘→ Next’.
+ +2. Select: ‘◉ Reinstall GRUB bootloader on ESP, MBR or PBR (root)’. Click ‘→ Next’.
+3. On the Select Boot Method:
+4. Click ‘✔Apply’.
+4. Click ‘✔Apply’.
5. In the Authenticate pop-up enter ‘demo’ for the ‘Password:’ prompt and click ‘Authenticate’.
6. A pop-up ‘Select /boot location:’ asks you to choose: If no encryption is in use, choose the ESP / EFI and then click ‘✔OK’.
7. Select the ESP aka EFI partition (if encryption is not in use) with the arrow and then click ‘✔OK’.
@@ -138,15 +146,15 @@You MUST be booted in Legacy/MBR mode to repair a Legacy installation with this app.
- -Repairing the bootloader by regenerating the GRUB configuration file is the most common use of this application and should be attempted first.
+Repairing the bootloader by regenerating the GRUB configuration file is the most common use of this application and should be attempted first.
Note: in the image below “Lexar 126GB SSD” is the physical “sda” device and “MX25Xfce” is a partition label. The app displays these as hints for your choices.
-
1. Boot MX Linux USB in Legacy mode. Run MX Boot Repair.
2. Leave selected: ‘◉ Reinstall GRUB bootloader’ on MBR. Click ‘→ Next’.
@@ -175,15 +183,15 @@The files will take some time to be regenerated, especially on a slower PC .
From the man update-initramfs:
- +The update-initramfs script manages your initramfs images on your lo‐cal box. It keeps track of the existing initramfs archives in /boot. There are three modes of operation create, update or delete. You must at least specify one of those modes.
The initramfs is a gzipped cpio archive. At boot time, the kernel unpacks that archive into RAM disk, mounts and uses it as initial root file system. All finding of the root device happens in this early userspace.
+Development history: Adrian
-License: here.
+License: license.
From aa5b1a9e8c9c4ff7dd2aa26089e70f0e90ac8927 Mon Sep 17 00:00:00 2001 From: Mike <68885164+FullScale4Me@users.noreply.github.com> Date: Mon, 19 Oct 2026 15:46:14 -0400 Subject: [PATCH 2/2] Formatting adjustments for MX-Viewer and Firefox. --- help/custom.css | 5 ++++- help/mx-boot-repair.html | 8 +++++--- 2 files changed, 9 insertions(+), 4 deletions(-) diff --git a/help/custom.css b/help/custom.css index cbc2da0..7770540 100644 --- a/help/custom.css +++ b/help/custom.css @@ -24,7 +24,6 @@ code { img { display: block; margin: auto; - width: 50%; padding: 15px 0; /* Adds space between each */ } @@ -32,6 +31,10 @@ p { margin: .2em; } +. center { + text-align:center; +} + .footer { border-top: 1px solid #d0d7de; color: #5f6368; diff --git a/help/mx-boot-repair.html b/help/mx-boot-repair.html index 203711f..2ed23b7 100644 --- a/help/mx-boot-repair.html +++ b/help/mx-boot-repair.html @@ -38,7 +38,7 @@Example at below of a One Time Boot Menu. Choose the option ▸UEFI Boot Sources or Legacy Boot Sources depending on how Linux was installed. If you know that the PC’s Linux installation was in Legacy mode then pick “Legacy Boot Sources”. Other PCs screens may vary.
-
+
It is always good to have your partitions labeled. This allows better recognition for where the ESP (EFI System Partition) is located. Some Linux distro’s install do not label the ESP nor the /root.
+TIP: you can open GParted and right click on partitions in order to give them labels e,g like “EFI-SYSTEM” or just “ESP” (without ” “). Labeling partitions is best done from a Live USB, as these partitions needs to be unmounted for GParted to set a label on the partition(s).
@@ -63,7 +65,7 @@Below is a view of a Windows hard disk layout prior to any partitions being labeled.
-2. Select: ◉ Repair GRUB configuration file. Click ‘→ Next’.
3. On the ‘Select GRUB location‘ screen in ‘Select root location:’ choose the MX Linux / root partition.
-
+
4. Click ‘✔Apply’.
5. In the ‘Authenticate‘ pop-up enter ‘demo’ for the ‘Password:’ prompt and click ‘Authenticate’.