Ubuntu 26.04 LTS – dist-upgrade aborts with held broken packages

📖 ~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 – dist-upgrade aborts with held broken packages. Security patches cannot be applied and dependency trees diverge.

Environment & Reproduction

Issue appears when mixed repositories, pinned versions, or interrupted upgrades exist.

# Baseline context
lsb_release -a
sudo apt-mark showhold
sudo apt-cache policy
sudo grep -R '^deb ' /etc/apt/sources.list /etc/apt/sources.list.d 2>/dev/null
sudo journalctl -p err -n 50 --no-pager

Root Cause Analysis

Held packages, incompatible third-party repositories, and partial upgrades commonly produce resolver failures during dist-upgrade.

Quick Triage

Validate package states and identify resolver blockers.

# Quick triage
sudo dpkg --audit
sudo apt-get check
sudo apt-mark showhold
sudo apt-cache unmet || true

Step-by-Step Diagnosis

Run simulation and inspect exact package conflicts.

# Detailed diagnosis
sudo apt-get update
sudo apt-get -s dist-upgrade
sudo apt-cache policy | sed -n '1,200p'
sudo grep -R '^Pin' /etc/apt/preferences /etc/apt/preferences.d 2>/dev/null || true

Solution – Primary Fix

Release holds, repair dependencies, and rerun upgrade in controlled order.

# Primary fix
sudo apt-mark unhold $(apt-mark showhold) || true
sudo apt-get -f install -y
sudo dpkg --configure -a
sudo apt-get update
sudo apt-get dist-upgrade -y

Solution – Alternative Approaches

Disable conflicting third-party repositories and retry with Ubuntu archives only.

# Alternative approach
sudo mkdir -p /root/apt-backup
sudo cp -a /etc/apt/sources.list.d /root/apt-backup/
sudo sed -i 's/^deb/#deb/g' /etc/apt/sources.list.d/*.list 2>/dev/null || true
sudo apt-get update
sudo apt-get dist-upgrade -y

Verification & Acceptance Criteria

No held/broken packages remain and simulated upgrades are clean.

# Verify
sudo apt-mark showhold
sudo dpkg --audit
sudo apt-get -s dist-upgrade
sudo apt-get check

Rollback Plan

Restore repository configuration and package versions if critical workload regressions appear.

# Rollback
sudo cp -a /root/apt-backup/sources.list.d /etc/apt/
sudo apt-get update
# Reinstall pinned versions as required from apt history

Prevention & Hardening

Use repository governance and maintenance windows to avoid resolver drift.

# Hardening
sudo apt-get install -y apt-listbugs
sudo apt-get install -y needrestart
sudo unattended-upgrades --dry-run --debug
sudo apt-config dump | grep -i -E 'Acquire|Unattended'

Related Errors & Cross-Refs

Related patterns include kept back packages, dependency is not satisfiable, and package has no installation candidate.

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

Ubuntu release upgrade and apt resolver documentation, plus apt pinning and preferences reference.