skip to content
Karan Ravindra

Fix Corrupted `update-initramfs.conf` on Raspberry Pi

/ 2 min read

raspberry-pi , linux , self-host

Overview

If you’re experiencing dpkg errors when running sudo apt update && sudo apt upgrade on your Raspberry Pi, the culprit may be a corrupted /etc/initramfs-tools/update-initramfs.conf file. This post walks through diagnosing the issue, restoring the configuration, and ensuring your system updates correctly.

Introduction

What Causes This Issue?

Some Raspberry Pi users have encountered errors during package updates due to corruption in the update-initramfs.conf file. Instead of valid configuration settings, the file contains unreadable characters, causing dpkg to fail.

Why Does This Matter?

The update-initramfs.conf file controls how the initramfs (initial RAM file system) updates during system upgrades. A corrupted file can disrupt essential system updates, leaving your Raspberry Pi in an inconsistent state.

Diagnosis

Checking for File Corruption

To confirm the issue, inspect the configuration file:

Terminal window
cat /etc/initramfs-tools/update-initramfs.conf

If you see gibberish or non-text characters, the file is corrupted and needs to be restored.

Fixing the Issue

Step 1: Backup and Remove the Corrupted File

If you have a backup, restore it. Otherwise, rename the corrupted file:

Terminal window
sudo mv /etc/initramfs-tools/update-initramfs.conf /etc/initramfs-tools/update-initramfs.conf.bak

Step 2: Recreate the Configuration File

Create a new file using:

Terminal window
sudo nano /etc/initramfs-tools/update-initramfs.conf

Paste the default settings:

# Configuration file for update-initramfs(8)
#
# Update initramfs? Yes or no.
update_initramfs=yes
#
# Do we want to force update of all initramfs?
update_initramfs=yes
#
# Generate a backup initramfs? Default is no.
backup_initramfs=no

Save and exit.

Restoring System Functionality

Step 3: Reconfigure and Fix Broken Packages

Run the following commands to fix any pending configuration issues:

Terminal window
sudo dpkg --configure -a
sudo apt --fix-broken install

Then, attempt the system update again:

Terminal window
sudo apt update && sudo apt upgrade -y

Step 4: Reinstall initramfs-tools (If Necessary)

If problems persist, reinstall the package:

Terminal window
sudo apt-get install --reinstall initramfs-tools

Results

After following these steps, your Raspberry Pi should update and upgrade without dpkg errors. Fixing the corrupted configuration file ensures a stable system and prevents further issues with initramfs updates.