Ubuntu 26.04 LTS – initramfs build fails with missing storage modules

📖 ~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

Administrators observe: Ubuntu 26.04 LTS – initramfs build fails with missing storage modules. Boot reliability is reduced after kernel updates.

Environment & Reproduction

Issue appears on custom kernels or systems with uncommon storage controllers.

# Baseline context
lsb_release -a
uname -r
lsblk
cat /etc/initramfs-tools/modules
sudo journalctl -p err -n 80 --no-pager

Root Cause Analysis

Required modules are absent from initramfs configuration or kernel package state is inconsistent.

Quick Triage

Check module availability and initramfs generation output.

# Quick triage
modinfo nvme || true
modinfo ahci || true
sudo update-initramfs -u -k all
sudo dpkg --audit

Step-by-Step Diagnosis

Inspect initramfs hooks and generated image contents.

# Detailed diagnosis
ls /usr/share/initramfs-tools/hooks
ls /usr/share/initramfs-tools/scripts
lsinitramfs /boot/initrd.img-$(uname -r) | head -n 120

Solution – Primary Fix

Add required modules, reinstall kernel package, and rebuild initramfs.

# Primary fix
echo -e 'nvme
ahci
ext4' | sudo tee /etc/initramfs-tools/modules
sudo apt-get install --reinstall -y linux-image-$(uname -r)
sudo update-initramfs -u -k all
sudo update-grub

Solution – Alternative Approaches

Use generic kernel meta-package to restore standard module set.

# Alternative
sudo apt-get install -y linux-generic
sudo update-initramfs -u -k all

Verification & Acceptance Criteria

initramfs generation completes cleanly and required modules exist in image.

# Verify
sudo update-initramfs -u -k all
lsinitramfs /boot/initrd.img-$(uname -r) | grep -E 'nvme|ahci|ext4'
sudo reboot

Rollback Plan

Revert module list edits and boot previous kernel if new image fails.

# Rollback
sudo cp -a /etc/initramfs-tools/modules /etc/initramfs-tools/modules.rollback.$(date +%F)
sudo update-initramfs -u -k all

Prevention & Hardening

Track custom module dependencies and test kernel updates in staging first.

# Hardening
sudo apt-mark showmanual | grep linux
sudo journalctl --since '30 days ago' --no-pager | grep -i initramfs || true

Related Errors & Cross-Refs

Related patterns include dropped to initramfs shell and unable to find root filesystem at boot.

Related tutorial: View the step-by-step tutorial for Ubuntu 26.04 LTS.

View all Ubuntu 26.04 LTS tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

initramfs-tools documentation and Ubuntu kernel packaging notes.