RHEL 10 – dnf module stream conflict blocks application install – 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

Installation fails with modular filtering or conflicting stream errors, blocking app deployment.

Environment & Reproduction

Seen when a package requires a different module stream than the enabled default.

dnf module list
dnf install -y nodejs

Root Cause Analysis

Previously enabled streams lock package sets that conflict with requested runtime versions.

Quick Triage

Check enabled module streams and package candidates.

dnf module list --enabled
dnf repoquery --whatprovides nodejs

Step-by-Step Diagnosis

Identify conflicting stream and evaluate stream reset impact.

dnf module info nodejs
dnf module list nodejs
dnf history userinstalled

Solution – Primary Fix

Reset the module and enable the required stream before install.

dnf module reset -y nodejs
dnf module enable -y nodejs:22
dnf install -y nodejs

Solution – Alternative Approaches

Use containerized runtime or AppStream alternatives to avoid host stream conflicts.

dnf module disable -y nodejs
podman run --rm registry.access.redhat.com/ubi10/nodejs-22 node -v

Verification & Acceptance Criteria

Required version installs successfully and module state aligns with policy.

dnf module list nodejs
node -v
journalctl -xe | tail -n 30

Rollback Plan

Re-enable prior stream and downgrade runtime if application compatibility breaks.

dnf history list
dnf history undo last
dnf module enable -y nodejs:18

Prevention & Hardening

Document approved module streams and enforce via provisioning templates.

dnf module list --enabled > /root/module-baseline.txt

Related Errors & Cross-Refs

Commonly linked to subscription channel mismatches and third-party repo overlap.

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

View all rhel-10 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Red Hat AppStream module stream management and compatibility guidance.