Ubuntu 22.04 LTS – apt install fails with broken dependencies – 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

Package installation fails and required services cannot be deployed due to unresolved dependencies.

Environment & Reproduction

Seen after partial upgrades, interrupted installs, or mixed repositories on Jammy.

Root Cause Analysis

The package graph contains conflicting or incomplete dependency state in dpkg metadata.

Quick Triage

Check held packages and pending dpkg actions before forcing package changes.

Step-by-Step Diagnosis

Review candidate versions and apt solver output to isolate conflicting packages.

Solution – Primary Fix

Repair package metadata and then install the target package with a clean dependency set.

Solution – Alternative Approaches

Remove obsolete conflicting packages and retry installation from official Jammy repositories.

Verification & Acceptance Criteria

No unmet dependencies remain and the package is fully installed and configured.

Rollback Plan

Remove newly installed packages if application compatibility issues are detected.

Prevention & Hardening

Keep third-party repositories minimal and avoid partial upgrades on production hosts.

Related Errors & Cross-Refs

Often linked with held packages, stale mirror metadata, or interrupted dpkg transactions.

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

View all Ubuntu 22.04 LTS tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Ubuntu package management guidance for dependency troubleshooting on Ubuntu 22.04 LTS.