Ubuntu 26.04 LTS – unmet dependencies and held packages during apt upgrade – 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

apt upgrade fails with unmet dependencies or held package conflicts, leaving systems partially patched.

Environment & Reproduction

Often appears after mixing PPAs, partial upgrades, or interrupted package operations.

cat /etc/os-release
apt policy | head -n 40
apt-mark showhold
sudo apt update

Root Cause Analysis

The dependency solver cannot find a consistent package set due to pinned versions, outdated metadata, or third-party repository skew.

Quick Triage

Capture holds, broken packages, and candidate versions before changing repository state.

apt-mark showhold
sudo apt --fix-broken install -y
sudo dpkg --audit
apt-cache policy PACKAGE

Step-by-Step Diagnosis

Trace conflicts and identify the package introducing version constraints.

sudo apt update
sudo apt upgrade --dry-run
sudo apt full-upgrade --dry-run
grep -R 'Pin:' /etc/apt/preferences*

Solution – Primary Fix

Repair package state, remove stale holds, and complete a full dependency-resolving upgrade.

sudo dpkg --configure -a
sudo apt --fix-broken install -y
sudo apt-mark unhold $(apt-mark showhold)
sudo apt update
sudo apt full-upgrade -y
sudo apt autoremove -y

Solution – Alternative Approaches

Disable conflicting PPAs temporarily and retry with official repositories only.

sudo add-apt-repository --remove ppa:EXAMPLE/PPA
sudo sed -i 's/^deb/# deb/g' /etc/apt/sources.list.d/*.list
sudo apt update
sudo apt install PACKAGE -y

Verification & Acceptance Criteria

Fix is accepted when upgrade completes and no broken or held package remains.

sudo apt full-upgrade -y
sudo apt --fix-broken install -y
apt-mark showhold
sudo dpkg --audit

Rollback Plan

If regressions occur, reinstall prior package versions and pin critical packages temporarily.

apt-cache madison PACKAGE
sudo apt install PACKAGE=VERSION -y
sudo apt-mark hold PACKAGE

Prevention & Hardening

Keep repository sources minimal and avoid cross-release or mixed-vendor package sets.

sudo apt install ubuntu-release-upgrader-core -y
sudo pro status
sudo apt update && sudo apt upgrade -y

Related Errors & Cross-Refs

Related errors include held broken packages, dependency problems prevent configuration, and requested an impossible situation.

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 packaging docs, apt preferences guidance, Launchpad PPA docs, and dpkg recovery references.