Ubuntu 24.04 LTS – CUPS print jobs stuck in queue – 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

Print jobs remain pending and documents are not produced.

Environment & Reproduction

Seen after network printer IP changes or backend errors.

lpstat -t
systemctl status cups
lpstat -p -d

Root Cause Analysis

Queue paused, stale backend URI, or filter crash blocks job processing.

Quick Triage

Check printer enablement and recent error logs.

lpstat -W not-completed
journalctl -u cups -n 120 --no-pager
lpoptions -p  -l

Step-by-Step Diagnosis

Validate backend reachability and queue health.

lpstat -v
ping -c 3 
sudo tail -n 100 /var/log/cups/error_log

Solution – Primary Fix

Purge stuck jobs, resume printer, and restart CUPS.

cancel -a
cupsenable 
cupsaccept 
sudo systemctl restart cups

Solution – Alternative Approaches

Recreate printer with corrected URI and driver.

sudo lpadmin -x 
sudo lpadmin -p  -E -v ipp:///ipp/print -m everywhere

Verification & Acceptance Criteria

Test page prints and queue drains to zero jobs.

lp -d  /etc/hosts
lpstat -W not-completed
lpstat -p 

Rollback Plan

Restore previous printer definition from backup script.

lpstat -v > /var/tmp/printers.before.txt
# restore with saved lpadmin commands

Prevention & Hardening

Use static printer IP reservations and monitor CUPS errors.

journalctl -u cups --since -24h --no-pager | grep -i error
lpstat -t

Related Errors & Cross-Refs

Often paired with DNS failures for printer hostnames.

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

View all Ubuntu 24.04 LTS tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Ubuntu CUPS administration and IPP Everywhere setup docs.