Ubuntu 26.04 LTS – do-release-upgrade blocked by held packages – 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

Release upgrade prechecks fail due to held or broken packages. The system remains on an older state and misses planned lifecycle updates.

Environment & Reproduction

Typically occurs after manual pinning, partial upgrades, or third-party repository drift.

lsb_release -a
sudo apt-mark showhold
sudo apt update
sudo do-release-upgrade -c

Root Cause Analysis

Held packages and pinned versions can block dependency resolution required by release tooling.

Quick Triage

List holds, pin files, and broken dependency indicators.

sudo apt-mark showhold
grep -RIn 'Pin:' /etc/apt/preferences /etc/apt/preferences.d 2>/dev/null
sudo apt -f install -y

Step-by-Step Diagnosis

Inspect resolver output and identify which packages prevent upgrade.

sudo apt-get -o Debug::pkgProblemResolver=yes dist-upgrade -s
sudo dpkg --audit
sudo tail -n 120 /var/log/dist-upgrade/main.log 2>/dev/null || true

Solution – Primary Fix

Clear unnecessary holds and repair package state before retrying release checks.

for p in $(apt-mark showhold); do sudo apt-mark unhold $p; done
sudo dpkg --configure -a
sudo apt -f install -y
sudo apt full-upgrade -y
sudo do-release-upgrade -c

Solution – Alternative Approaches

Temporarily disable non-Ubuntu repositories to reduce dependency conflicts.

sudo mkdir -p /var/tmp/apt-sources-backup
sudo cp -a /etc/apt/sources.list.d /var/tmp/apt-sources-backup/
sudo sed -i 's/^deb/#deb/g' /etc/apt/sources.list.d/*.list
sudo apt update

Verification & Acceptance Criteria

No held packages remain and release precheck completes successfully.

sudo apt-mark showhold
sudo apt-get check
sudo do-release-upgrade -c

Rollback Plan

Reapply essential holds if application compatibility requires specific package versions.

sudo apt-mark hold 
sudo cp -a /var/tmp/apt-sources-backup/sources.list.d/* /etc/apt/sources.list.d/
sudo apt update

Prevention & Hardening

Track package holds in configuration management and review before upgrade windows.

apt-mark showhold > /var/tmp/held-packages.txt
apt-cache policy | head -n 120

Related Errors & Cross-Refs

Often paired with broken packages, obsolete PPAs, or stale apt preference pinning.

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 pinning documentation for supported transition paths.