Ubuntu 26.04 LTS – apt 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

Security and feature updates remain pending because key packages are held.

Environment & Reproduction

Occurs when previous maintenance pinned package versions.

sudo apt upgrade

Root Cause Analysis

apt-mark hold prevents upgrades needed by dependency chains.

Quick Triage

List held packages and evaluate if holds are still required.

apt-mark showhold
apt list --upgradable

Step-by-Step Diagnosis

Check package policies and impacted upgrade graph.

apt-cache policy 
sudo apt full-upgrade --dry-run

Solution – Primary Fix

Unhold only approved packages and perform a controlled upgrade.

sudo apt-mark unhold 
sudo apt update
sudo apt full-upgrade

Solution – Alternative Approaches

Keep hold in place and apply only compatible security fixes manually.

sudo apt install =

Verification & Acceptance Criteria

Upgrade completes and the package list reflects expected versions.

apt-mark showhold
apt list --installed | grep 

Rollback Plan

Reapply hold and revert package version if application compatibility fails.

sudo apt-mark hold 

Prevention & Hardening

Track hold decisions in change records with expiry dates and owners.

Related Errors & Cross-Refs

Often linked with unmet dependencies and partial upgrades.

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 apt-mark and upgrade lifecycle best practices.