Debian 9 – GRUB update fails after kernel upgrade – Fix & Prevention

📖 ~1 min read

Table of contents

1. Symptom & Impact
2. Environment & Reproduction
3. Root Cause Analysis
4. Quick Triage
5. Step-by-Step Diagnosis
6. Solution – Primary Fix
7. Solution – Alternative Approaches
8. Verification & Acceptance Criteria
9. Rollback Plan
10. Prevention & Hardening
11. Related Errors & Cross-Refs
12. References & Further Reading

Symptom & Impact

Kernel upgrades complete but bootloader update fails, risking unbootable restart.

Environment & Reproduction

Appears on UEFI/BIOS mismatch or changed disk mappings.

sudo apt install -y linux-image-amd64
sudo update-grub
sudo grub-install /dev/sda

Root Cause Analysis

Incorrect target disk, missing EFI mount, or corrupted bootloader files.

Quick Triage

Check firmware mode, mounted ESP, and grub errors.

[ -d /sys/firmware/efi ] && echo UEFI || echo BIOS
findmnt /boot/efi
sudo journalctl -p err -n 80 --no-pager

Step-by-Step Diagnosis

Confirm disk layout and current grub package status.

lsblk -f
sudo efibootmgr -v
dpkg -l | grep grub-efi

Solution – Primary Fix

Mount ESP properly, reinstall GRUB, and rebuild menu.

sudo mount /boot/efi || true
sudo grub-install
sudo update-grub
sudo apt -f install -y

Solution – Alternative Approaches

For BIOS systems, target the correct whole disk explicitly.

sudo grub-install /dev/sda
sudo update-grub

Verification & Acceptance Criteria

grub commands exit successfully and boot entries are present.

sudo grub-install --version
grep -E '^menuentry' /boot/grub/grub.cfg | head
sudo efibootmgr -v

Rollback Plan

Boot previous kernel from menu and restore prior GRUB backup.

sudo cp -a /boot/grub /var/tmp/grub.bak.$(date +%s)
sudo update-grub

Prevention & Hardening

Validate boot mode and disk mapping before kernel maintenance.

lsblk -f
findmnt /boot/efi
sudo apt-mark showhold | grep grub || true

Related Errors & Cross-Refs

Often coupled with /boot space exhaustion and initramfs failures.

Related tutorial: View the step-by-step tutorial for Debian 9.

View all Debian 9 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Debian GRUB and EFI maintenance documentation.