Ubuntu 20.04 printer not printing or stuck in queue

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

Print jobs remain queued or fail silently, affecting productivity and document workflows.

Environment & Reproduction

Printer appears installed but jobs show held, stopped, or backend communication errors.

Root Cause Analysis

CUPS service issues, incorrect driver or PPD, connection failures, and permission constraints.

Quick Triage

Check printer power and network reachability, then restart CUPS and clear blocked jobs.

Step-by-Step Diagnosis

Use lpstat -t, systemctl status cups, and review /var/log/cups/error_log entries.

Solution – Primary Fix

Reinstall printer with correct driver, resume queue, and validate backend connectivity settings.

Solution – Alternative Approaches

Switch to IPP Everywhere or vendor package if generic PPD compatibility is poor.

Verification & Acceptance Criteria

Test pages print consistently and queues drain without repeated holds or errors.

Rollback Plan

Restore previous working printer config and PPD from backup if changes fail.

Prevention & Hardening

Keep CUPS and printer firmware updated; remove stale duplicate queue definitions.

Related Errors & Cross-Refs

Often connected to DNS hostname issues, firewall rules, and authentication prompts.

Related tutorial: View the step-by-step tutorial for Ubuntu 20.04 LTS.

View all Ubuntu 20.04 LTS tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Refer to CUPS administration docs and Ubuntu printer setup guidance for Focal.