Fix Broken Dependencies After Ubuntu 24.04 LTS Upgrade

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

apt reports unmet dependencies and blocks security updates.

Environment & Reproduction

Usually appears after interrupted upgrades or leftover third-party repositories.

Root Cause Analysis

Package versions from mixed repos cannot satisfy Ubuntu 24.04 dependency chains.

Quick Triage

Run sudo apt –fix-broken install and sudo apt-mark showhold.

Step-by-Step Diagnosis

Inspect sources with grep -R ‘^deb ‘ /etc/apt/sources.list /etc/apt/sources.list.d and check /var/log/dist-upgrade/main.log.

Solution – Primary Fix

Disable incompatible entries, then run sudo apt update && sudo apt –fix-broken install && sudo apt full-upgrade.

Solution – Alternative Approaches

Temporarily remove conflicting packages using sudo apt remove package-name.

Verification & Acceptance Criteria

sudo apt check returns clean and sudo apt full-upgrade completes.

Rollback Plan

Restore /etc/apt from backup and retry with official Ubuntu mirrors only.

Prevention & Hardening

Disable PPAs before major upgrades and keep snapshot backups.

Related Errors & Cross-Refs

Related: ‘held broken packages’ and ‘depends but it is not installable’.

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

View all Ubuntu 24.04 LTS tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Ubuntu release upgrade documentation and man sources.list.