DNF Update Hangs or Is Extremely Slow

📖 ~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

dnf update appears stuck at metadata sync or package download for long periods.

Environment & Reproduction

Test DNS and latency to mirrors, then run dnf -v update to identify where delays occur.

Root Cause Analysis

Mirror selection, proxy throttling, or IPv6 path issues introduce download stalls.

Quick Triage

Configure fastestmirror, set stable baseurl when needed, and test with –setopt=ip_resolve=4 if IPv6 is unstable.

Step-by-Step Diagnosis

Save verbose dnf output showing slow mirror negotiation or connection retries.

Solution – Primary Fix

dnf update advances steadily with normal throughput and no repeated retry lines.

Solution – Alternative Approaches

Run timed dnf makecache and compare duration before and after network and mirror adjustments.

Verification & Acceptance Criteria

Prefer internal mirror proxies for production and monitor repository response times.

Rollback Plan

Revert modified dnf.conf options if they degrade behavior in other network segments.

Prevention & Hardening

Use managed templates for /etc/dnf/dnf.conf and apply per-site mirror configuration.

Related Errors & Cross-Refs

Check /var/log/dnf.log and network telemetry for packet loss, DNS retries, and TLS delays.

Related tutorial: View the step-by-step tutorial for rhel-9.

View all rhel-9 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Share traceroute, mirror URLs, proxy path, and dnf verbose logs when escalating.